/* ====================================
   VELORA GROUNDING PRIMITIVES
   Component primitives enforcing grounding rules
   ==================================== */

/* ========================================
   GROUNDED CARD
   Enforces surface + stroke + tight shadow
   ======================================== */

.grounded-card {
    background: var(--surface-card, #ffffff);
    border: 1px solid var(--stroke-subtle, rgba(0, 0, 0, 0.08));
    border-radius: var(--radius-lg, 16px);
    padding: var(--space-6, 1.5rem) var(--space-8, 2rem);
    /* Grounding: border + tight shadow */
    box-shadow: var(--shadow-tight, 0 1px 2px rgba(0, 0, 0, 0.05), 0 1px 3px rgba(0, 0, 0, 0.1));
    transition: all var(--motion-ui-base, 180ms) var(--ease-ui, cubic-bezier(0.4, 0, 0.2, 1));
    display: flex;
    flex-direction: column;
}

.grounded-card:hover {
    border-color: var(--stroke-base, rgba(0, 0, 0, 0.12));
    box-shadow: var(--shadow-subtle, 0 2px 4px rgba(0, 0, 0, 0.06), 0 4px 8px rgba(0, 0, 0, 0.08));
}

.grounded-card:active {
    transform: var(--press-down, translateY(1px));
}

.grounded-card:focus-visible {
    outline: var(--focus-ring-width, 2px) solid var(--focus-ring-color, #6B46C1);
    outline-offset: var(--focus-ring-offset, 2px);
}

/* ========================================
   GROUNDED SECTION
   Enforces spacing rhythm
   ======================================== */

.grounded-section {
    padding: var(--space-12, 3rem) var(--space-4, 1rem);
}

@media (max-width: 768px) {
    .grounded-section {
        padding: var(--space-8, 2rem) var(--space-4, 1rem);
    }
}

@media (max-width: 480px) {
    .grounded-section {
        padding: var(--space-6, 1.5rem) var(--space-3, 0.75rem);
    }
}

/* ========================================
   GROUNDED STACK
   Vertical spacing component
   ======================================== */

.grounded-stack {
    display: flex;
    flex-direction: column;
    gap: var(--space-4, 1rem);
}

.grounded-stack-sm {
    gap: var(--space-2, 0.5rem);
}

.grounded-stack-md {
    gap: var(--space-4, 1rem);
}

.grounded-stack-lg {
    gap: var(--space-6, 1.5rem);
}

.grounded-stack-xl {
    gap: var(--space-8, 2rem);
}

/* ========================================
   GROUNDED GRID
   Grid with consistent gaps using spacing scale
   ======================================== */

.grounded-grid {
    display: grid;
    gap: var(--space-6, 1.5rem);
}

.grounded-grid-sm {
    gap: var(--space-4, 1rem);
}

.grounded-grid-md {
    gap: var(--space-6, 1.5rem);
}

.grounded-grid-lg {
    gap: var(--space-8, 2rem);
}

.grounded-grid-xl {
    gap: var(--space-12, 3rem);
}

/* Responsive gap scaling */
@media (max-width: 640px) {
    .grounded-grid {
        gap: var(--space-4, 1rem);
    }
    
    .grounded-grid-lg {
        gap: var(--space-6, 1.5rem);
    }
    
    .grounded-grid-xl {
        gap: var(--space-8, 2rem);
    }
}

@media (max-width: 480px) {
    .grounded-grid {
        gap: var(--space-3, 0.75rem);
    }
    
    .grounded-grid-md {
        gap: var(--space-4, 1rem);
    }
    
    .grounded-grid-lg {
        gap: var(--space-6, 1.5rem);
    }
}

/* ========================================
   SPACING UTILITIES
   Enforce spacing scale (4/8/12/16/24/32/48/64px)
   ======================================== */

.grounded-space-1 { margin: var(--space-1, 0.25rem); }
.grounded-space-2 { margin: var(--space-2, 0.5rem); }
.grounded-space-3 { margin: var(--space-3, 0.75rem); }
.grounded-space-4 { margin: var(--space-4, 1rem); }
.grounded-space-6 { margin: var(--space-6, 1.5rem); }
.grounded-space-8 { margin: var(--space-8, 2rem); }
.grounded-space-12 { margin: var(--space-12, 3rem); }
.grounded-space-16 { margin: var(--space-16, 4rem); }

.grounded-p-1 { padding: var(--space-1, 0.25rem); }
.grounded-p-2 { padding: var(--space-2, 0.5rem); }
.grounded-p-3 { padding: var(--space-3, 0.75rem); }
.grounded-p-4 { padding: var(--space-4, 1rem); }
.grounded-p-6 { padding: var(--space-6, 1.5rem); }
.grounded-p-8 { padding: var(--space-8, 2rem); }
.grounded-p-12 { padding: var(--space-12, 3rem); }
.grounded-p-16 { padding: var(--space-16, 4rem); }

.grounded-gap-1 { gap: var(--space-1, 0.25rem); }
.grounded-gap-2 { gap: var(--space-2, 0.5rem); }
.grounded-gap-3 { gap: var(--space-3, 0.75rem); }
.grounded-gap-4 { gap: var(--space-4, 1rem); }
.grounded-gap-6 { gap: var(--space-6, 1.5rem); }
.grounded-gap-8 { gap: var(--space-8, 2rem); }
.grounded-gap-12 { gap: var(--space-12, 3rem); }
.grounded-gap-16 { gap: var(--space-16, 4rem); }

/* ========================================
   DOCUMENTATION COMMENTS
   ======================================== */

/* 
 * GROUNDING RULES ENFORCEMENT:
 * 
 * 1. Spacing: Use only spacing scale values (4/8/12/16/24/32/48/64px)
 *    - Avoid arbitrary values like [10px], [15px], [18px]
 *    - Use grounding tokens: --space-1 through --space-16
 * 
 * 2. Shadows: Max 3 levels (tight, subtle, elevated)
 *    - Avoid shadow-xl, shadow-2xl
 *    - Use border + shadow-tight instead of big shadows
 * 
 * 3. Motion: UI < 220ms, sections < 420ms
 *    - Use --motion-ui-* tokens
 *    - Max translateY: 6px for UI, 12px for sections
 * 
 * 4. Surfaces: Use surface tokens (base, card, soft)
 *    - Warm off-white base, not pure white
 *    - Paper-like card surfaces
 * 
 * 5. Interactions: Mechanical feedback
 *    - :active press (1-2px translateY)
 *    - :hover contrast change, not scale
 *    - Crisp focus rings (2px)
 */