/*
 * NAMKC Youth Website - Main Styles
 * Base typography, layout system, and utility classes
 * Mobile-first responsive design approach
 */

/* ============================
   GOOGLE FONTS IMPORT
   ============================ */

@import url('https://fonts.googleapis.com/css2?family=Montserrat:wght@400;600;700&family=Open+Sans:wght@400;600&display=swap');

/* ============================
   BASE TYPOGRAPHY
   ============================ */

body {
  font-family: var(--font-body);
  font-size: var(--font-size-body);
  font-weight: var(--font-weight-regular);
  line-height: var(--line-height-relaxed);
  color: var(--color-text-primary);
  background-color: var(--color-bg-primary);
  /* Improve text rendering */
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}

/* ============================
   HEADINGS
   ============================ */

h1, h2, h3, h4, h5, h6 {
  font-family: var(--font-heading);
  line-height: var(--line-height-tight);
  letter-spacing: var(--letter-spacing-tight);
  color: var(--color-primary);
  margin-bottom: var(--spacing-md);
  /* Prevent text overflow */
  overflow-wrap: break-word;
  word-wrap: break-word;
}

h1 {
  font-size: var(--font-size-h1);
  font-weight: var(--font-weight-bold);
  margin-bottom: var(--spacing-lg);
}

h2 {
  font-size: var(--font-size-h2);
  font-weight: var(--font-weight-bold);
  margin-bottom: var(--spacing-lg);
}

h3 {
  font-size: var(--font-size-h3);
  font-weight: var(--font-weight-semibold);
  margin-bottom: var(--spacing-md);
}

h4 {
  font-size: var(--font-size-h4);
  font-weight: var(--font-weight-semibold);
  margin-bottom: var(--spacing-md);
}

h5 {
  font-size: var(--font-size-h5);
  font-weight: var(--font-weight-semibold);
  margin-bottom: var(--spacing-sm);
}

h6 {
  font-size: var(--font-size-body);
  font-weight: var(--font-weight-semibold);
  margin-bottom: var(--spacing-sm);
}

/* ============================
   PARAGRAPHS & TEXT ELEMENTS
   ============================ */

p {
  margin-bottom: var(--spacing-md);
  /* Optimal reading width */
  max-width: 75ch;
}

/* Last paragraph in a section should have no bottom margin */
p:last-child {
  margin-bottom: 0;
}

strong, b {
  font-weight: var(--font-weight-semibold);
  color: var(--color-text-primary);
}

em, i {
  font-style: italic;
}

small {
  font-size: var(--font-size-small);
  color: var(--color-text-secondary);
}

/* ============================
   LINKS
   ============================ */

a {
  color: var(--color-primary);
  font-weight: var(--font-weight-semibold);
  text-decoration: none;
  transition: color var(--transition-fast);
}

a:hover {
  color: var(--color-accent);
  text-decoration: underline;
}

a:focus-visible {
  outline: 2px solid var(--color-accent);
  outline-offset: 2px;
  border-radius: var(--radius-small);
}

/* ============================
   LISTS
   ============================ */

ul, ol {
  margin-bottom: var(--spacing-md);
  padding-left: var(--spacing-lg);
}

/* Restore list styles for content lists */
.content ul {
  list-style: disc;
}

.content ol {
  list-style: decimal;
}

li {
  margin-bottom: var(--spacing-sm);
  line-height: var(--line-height-relaxed);
}

li:last-child {
  margin-bottom: 0;
}

/* ============================
   BLOCKQUOTES
   ============================ */

blockquote {
  padding: var(--spacing-md) var(--spacing-lg);
  margin: var(--spacing-lg) 0;
  border-left: 4px solid var(--color-accent);
  background-color: var(--color-bg-alternate);
  font-style: italic;
  color: var(--color-text-secondary);
}

blockquote p {
  margin-bottom: var(--spacing-sm);
}

blockquote cite {
  display: block;
  font-size: var(--font-size-small);
  color: var(--color-text-light);
  font-style: normal;
  margin-top: var(--spacing-sm);
}

/* ============================
   LAYOUT SYSTEM
   ============================ */

/* Container - Centers content and provides padding */
.container {
  width: 100%;
  max-width: var(--container-large);
  margin-left: auto;
  margin-right: auto;
  padding-left: var(--spacing-md);
  padding-right: var(--spacing-md);
}

/* Responsive container adjustments */
@media (min-width: 768px) {
  .container {
    padding-left: var(--spacing-lg);
    padding-right: var(--spacing-lg);
  }
}

@media (min-width: 1024px) {
  .container {
    padding-left: var(--spacing-xl);
    padding-right: var(--spacing-xl);
  }
}

/* ============================
   GRID SYSTEM
   ============================ */

.grid {
  display: grid;
  gap: var(--grid-gutter-mobile);
  width: 100%;
}

/* Common grid patterns */
.grid-1 {
  grid-template-columns: 1fr;
}

.grid-2 {
  grid-template-columns: 1fr;
}

.grid-3 {
  grid-template-columns: 1fr;
}

.grid-4 {
  grid-template-columns: 1fr;
}

/* Tablet grid adjustments */
@media (min-width: 768px) {
  .grid {
    gap: var(--grid-gutter-tablet);
  }

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

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

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

/* Desktop grid adjustments */
@media (min-width: 1024px) {
  .grid {
    gap: var(--grid-gutter-desktop);
  }

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

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

/* ============================
   SECTION LAYOUT
   ============================ */

section {
  padding: var(--spacing-2xl) 0;
}

/* Alternate background sections */
section.bg-alternate {
  background-color: var(--color-bg-alternate);
}

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

/* ============================
   UTILITY CLASSES
   ============================ */

/* Spacing Utilities */
.mt-xs { margin-top: var(--spacing-xs); }
.mt-sm { margin-top: var(--spacing-sm); }
.mt-md { margin-top: var(--spacing-md); }
.mt-lg { margin-top: var(--spacing-lg); }
.mt-xl { margin-top: var(--spacing-xl); }
.mt-2xl { margin-top: var(--spacing-2xl); }
.mt-3xl { margin-top: var(--spacing-3xl); }

.mb-xs { margin-bottom: var(--spacing-xs); }
.mb-sm { margin-bottom: var(--spacing-sm); }
.mb-md { margin-bottom: var(--spacing-md); }
.mb-lg { margin-bottom: var(--spacing-lg); }
.mb-xl { margin-bottom: var(--spacing-xl); }
.mb-2xl { margin-bottom: var(--spacing-2xl); }
.mb-3xl { margin-bottom: var(--spacing-3xl); }

.pt-xs { padding-top: var(--spacing-xs); }
.pt-sm { padding-top: var(--spacing-sm); }
.pt-md { padding-top: var(--spacing-md); }
.pt-lg { padding-top: var(--spacing-lg); }
.pt-xl { padding-top: var(--spacing-xl); }
.pt-2xl { padding-top: var(--spacing-2xl); }
.pt-3xl { padding-top: var(--spacing-3xl); }

.pb-xs { padding-bottom: var(--spacing-xs); }
.pb-sm { padding-bottom: var(--spacing-sm); }
.pb-md { padding-bottom: var(--spacing-md); }
.pb-lg { padding-bottom: var(--spacing-lg); }
.pb-xl { padding-bottom: var(--spacing-xl); }
.pb-2xl { padding-bottom: var(--spacing-2xl); }
.pb-3xl { padding-bottom: var(--spacing-3xl); }

/* Text Alignment */
.text-left { text-align: left; }
.text-center { text-align: center; }
.text-right { text-align: right; }

/* Text Colors */
.text-primary { color: var(--color-primary); }
.text-secondary { color: var(--color-text-secondary); }
.text-accent { color: var(--color-accent); }
.text-light { color: var(--color-text-light); }

/* Display Utilities */
.hidden { display: none; }
.block { display: block; }
.inline-block { display: inline-block; }
.flex { display: flex; }
.grid-display { display: grid; }

/* Flexbox Utilities */
.flex-row { flex-direction: row; }
.flex-column { flex-direction: column; }
.justify-start { justify-content: flex-start; }
.justify-center { justify-content: center; }
.justify-end { justify-content: flex-end; }
.justify-between { justify-content: space-between; }
.align-start { align-items: flex-start; }
.align-center { align-items: center; }
.align-end { align-items: flex-end; }
.gap-sm { gap: var(--spacing-sm); }
.gap-md { gap: var(--spacing-md); }
.gap-lg { gap: var(--spacing-lg); }

/* Width Utilities */
.w-full { width: 100%; }
.w-auto { width: auto; }

/* Max Width Utilities */
.max-w-sm { max-width: 640px; }
.max-w-md { max-width: 768px; }
.max-w-lg { max-width: 1024px; }
.max-w-xl { max-width: 1280px; }

/* ============================
   SKIP TO CONTENT LINK
   ============================ */

.skip-to-content {
  position: absolute;
  top: -100px;
  left: var(--spacing-md);
  background: var(--color-primary);
  color: var(--color-bg-primary);
  padding: var(--spacing-sm) var(--spacing-md);
  border-radius: var(--radius-small);
  text-decoration: none;
  font-weight: var(--font-weight-semibold);
  z-index: var(--z-index-modal);
  transition: top var(--transition-fast);
}

.skip-to-content:focus {
  top: var(--spacing-md);
  outline: 2px solid var(--color-accent);
  outline-offset: 2px;
}

/*
 * DEVELOPER NOTES:
 *
 * Layout System Usage:
 * - Use .container to center and constrain content width
 * - Use .grid with .grid-2, .grid-3, or .grid-4 for responsive grids
 * - Sections automatically have vertical padding
 *
 * Typography:
 * - All headings use Montserrat, body text uses Open Sans
 * - Font sizes scale automatically on tablet/desktop (see variables.css)
 * - Paragraphs have optimal max-width (75ch) for readability
 *
 * Utilities:
 * - Use spacing utilities (mt-*, mb-*, etc.) for consistent spacing
 * - Flexbox utilities available for quick layouts
 * - Text utilities for alignment and colors
 *
 * Accessibility:
 * - Skip to content link for keyboard navigation
 * - Focus styles on all interactive elements
 * - Color contrast meets WCAG AA standards
 * - Semantic HTML required for proper structure
 */