/* ==========================================================================
   claudecodetutorials.com — Site-wide theme
   ==========================================================================

   This file provides the shared design system for the entire site:
   - Self-hosted font declarations
   - CSS custom properties (colors, typography, spacing)
   - Base element styles (typography, links, buttons)
   - Reusable component classes (header, footer, cards, terminals, etc.)

   USAGE:
   Load this stylesheet on every page. Page-specific styles can be added
   after it and will inherit the design tokens.

   In your base Flask template:
     <link rel="stylesheet" href="{{ url_for('static', filename='css/theme.css') }}">

   FILE LAYOUT ASSUMED:
     /static/css/theme.css                       (this file)
     /static/fonts/fraunces-v38/*.woff2
     /static/fonts/inter-v20/*.woff2
     /static/fonts/jetbrains-mono-v24/*.woff2
   ========================================================================== */


/* ==========================================================================
   1. FONTS
   ========================================================================== */

@font-face {
  font-family: 'Fraunces';
  src: url('/static/fonts/fraunces-v38/fraunces-v38-latin-regular.woff2') format('woff2');
  font-weight: 400; font-style: normal; font-display: swap;
}
@font-face {
  font-family: 'Fraunces';
  src: url('/static/fonts/fraunces-v38/fraunces-v38-latin-500.woff2') format('woff2');
  font-weight: 500; font-style: normal; font-display: swap;
}
@font-face {
  font-family: 'Fraunces';
  src: url('/static/fonts/fraunces-v38/fraunces-v38-latin-600.woff2') format('woff2');
  font-weight: 600; font-style: normal; font-display: swap;
}
@font-face {
  font-family: 'Fraunces';
  src: url('/static/fonts/fraunces-v38/fraunces-v38-latin-italic.woff2') format('woff2');
  font-weight: 400; font-style: italic; font-display: swap;
}
@font-face {
  font-family: 'Fraunces';
  src: url('/static/fonts/fraunces-v38/fraunces-v38-latin-500italic.woff2') format('woff2');
  font-weight: 500; font-style: italic; font-display: swap;
}
@font-face {
  font-family: 'Fraunces';
  src: url('/static/fonts/fraunces-v38/fraunces-v38-latin-600italic.woff2') format('woff2');
  font-weight: 600; font-style: italic; font-display: swap;
}
@font-face {
  font-family: 'Inter';
  src: url('/static/fonts/inter-v20/inter-v20-latin-regular.woff2') format('woff2');
  font-weight: 400; font-style: normal; font-display: swap;
}
@font-face {
  font-family: 'Inter';
  src: url('/static/fonts/inter-v20/inter-v20-latin-500.woff2') format('woff2');
  font-weight: 500; font-style: normal; font-display: swap;
}
@font-face {
  font-family: 'Inter';
  src: url('/static/fonts/inter-v20/inter-v20-latin-600.woff2') format('woff2');
  font-weight: 600; font-style: normal; font-display: swap;
}
@font-face {
  font-family: 'JetBrains Mono';
  src: url('/static/fonts/jetbrains-mono-v24/jetbrains-mono-v24-latin-regular.woff2') format('woff2');
  font-weight: 400; font-style: normal; font-display: swap;
}
@font-face {
  font-family: 'JetBrains Mono';
  src: url('/static/fonts/jetbrains-mono-v24/jetbrains-mono-v24-latin-500.woff2') format('woff2');
  font-weight: 500; font-style: normal; font-display: swap;
}
@font-face {
  font-family: 'JetBrains Mono';
  src: url('/static/fonts/jetbrains-mono-v24/jetbrains-mono-v24-latin-600.woff2') format('woff2');
  font-weight: 600; font-style: normal; font-display: swap;
}


/* ==========================================================================
   2. DESIGN TOKENS
   Named semantically so intent is obvious; change values here to rebrand.
   ========================================================================== */

:root {
  /* Colors: neutrals */
  --color-bg: #faf8f3;
  --color-surface: #ffffff;
  --color-ink: #1a1a1a;
  --color-ink-soft: #4a4a4a;
  --color-ink-mute: #7a7a7a;
  --color-rule: #e8e4d8;

  /* Colors: brand accent */
  --color-accent: #2d6a4f;
  --color-accent-soft: #d8e8de;

  /* Colors: terminal */
  --color-terminal-bg: #1a1d23;
  --color-terminal-bar: #252930;
  --color-terminal-ink: #e8e4d8;
  --color-terminal-green: #7dd3a0;
  --color-terminal-mute: #8a8a8a;
  --color-terminal-amber: #f4c07a;
  --color-terminal-red: #ff8a7b;

  /* Typography */
  --font-display: 'Fraunces', Georgia, serif;
  --font-body: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
  --font-mono: 'JetBrains Mono', ui-monospace, 'SF Mono', Menlo, monospace;

  /* Spacing scale */
  --space-1: 4px;
  --space-2: 8px;
  --space-3: 12px;
  --space-4: 16px;
  --space-5: 24px;
  --space-6: 32px;
  --space-7: 48px;
  --space-8: 64px;
  --space-9: 80px;
  --space-10: 96px;

  /* Layout */
  --container-width: 1120px;
  --container-padding: 32px;

  /* Radii */
  --radius-sm: 4px;
  --radius-md: 6px;
  --radius-lg: 10px;
  --radius-xl: 12px;

  /* Shadows */
  --shadow-sm: 0 1px 2px rgba(26, 26, 26, 0.04);
  --shadow-md: 0 4px 12px rgba(26, 26, 26, 0.06);
  --shadow-lg: 0 16px 32px -12px rgba(26, 26, 26, 0.12);
  --shadow-xl: 0 24px 48px -12px rgba(26, 26, 26, 0.25), 0 0 0 1px rgba(26, 26, 26, 0.05);

  /* Transitions */
  --ease: cubic-bezier(0.4, 0, 0.2, 1);
  --dur-fast: 0.15s;
  --dur: 0.25s;
}


/* ==========================================================================
   3. RESET & BASE
   ========================================================================== */

*, *::before, *::after {
  box-sizing: border-box;
  margin: 0;
  padding: 0;
}

html {
  scroll-behavior: smooth;
  -webkit-text-size-adjust: 100%;
}

body {
  font-family: var(--font-body);
  background: var(--color-bg);
  color: var(--color-ink);
  line-height: 1.6;
  font-size: 16px;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  font-feature-settings: "ss01", "cv11";
}

img, svg, video {
  max-width: 100%;
  height: auto;
  display: block;
}


/* ==========================================================================
   4. TYPOGRAPHY
   Use these classes OR style h1-h6 directly — both are covered.
   ========================================================================== */

h1, h2, h3, h4, h5, h6,
.h1, .h2, .h3, .h4, .h5 {
  font-family: var(--font-display);
  font-weight: 500;
  letter-spacing: -0.025em;
  line-height: 1.15;
  color: var(--color-ink);
}

h1, .h1 { font-size: clamp(32px, 4.5vw, 52px); letter-spacing: -0.035em; line-height: 1.05; }
h2, .h2 { font-size: clamp(28px, 3.5vw, 36px); }
h3, .h3 { font-size: 22px; }
h4, .h4 { font-size: 18px; }
h5, .h5 { font-size: 15px; }

p { margin: 0 0 1em; }
p:last-child { margin-bottom: 0; }

a {
  color: var(--color-accent);
  text-decoration: none;
  transition: color var(--dur-fast) var(--ease);
}
a:hover { color: var(--color-ink); }

strong { font-weight: 600; }
em { font-style: italic; }

code, kbd, samp, pre {
  font-family: var(--font-mono);
  font-size: 0.92em;
}

code {
  background: var(--color-accent-soft);
  color: var(--color-accent);
  padding: 2px 6px;
  border-radius: var(--radius-sm);
  font-weight: 500;
}

pre {
  background: var(--color-terminal-bg);
  color: var(--color-terminal-ink);
  padding: var(--space-5);
  border-radius: var(--radius-lg);
  overflow-x: auto;
  line-height: 1.6;
}
pre code {
  background: transparent;
  color: inherit;
  padding: 0;
  font-weight: 400;
}

hr {
  border: 0;
  border-top: 1px solid var(--color-rule);
  margin: var(--space-7) 0;
}

blockquote {
  border-left: 3px solid var(--color-accent);
  padding: var(--space-2) var(--space-5);
  margin: var(--space-5) 0;
  color: var(--color-ink-soft);
  font-style: italic;
}

/* Section labels (small monospace headings used throughout the design) */
.section-label {
  font-family: var(--font-mono);
  font-size: 12px;
  color: var(--color-ink-mute);
  letter-spacing: 0.05em;
  text-transform: uppercase;
  margin-bottom: var(--space-2);
  font-weight: 500;
}


/* ==========================================================================
   5. LAYOUT
   ========================================================================== */

.container {
  max-width: var(--container-width);
  margin: 0 auto;
  padding: 0 var(--container-padding);
}

.container-narrow {
  max-width: 720px;
  margin: 0 auto;
  padding: 0 var(--container-padding);
}

section {
  padding: var(--space-9) 0;
}

.section-head {
  display: flex;
  justify-content: space-between;
  align-items: baseline;
  margin-bottom: var(--space-7);
  gap: var(--space-7);
}
.section-head__title {
  flex: 1;
}
.section-head__aside {
  color: var(--color-ink-soft);
  font-size: 16px;
  max-width: 420px;
  text-align: right;
}

/* Surface containers */
.surface-light {
  background: var(--color-surface);
  border-top: 1px solid var(--color-rule);
  border-bottom: 1px solid var(--color-rule);
}
.surface-dark {
  background: var(--color-ink);
  color: rgba(255,255,255,0.85);
}


/* ==========================================================================
   6. HEADER
   Used on every page. Sticky, blurs background on scroll.
   ========================================================================== */

.site-header {
  border-bottom: 1px solid var(--color-rule);
  padding: 20px 0;
  position: sticky;
  top: 0;
  z-index: 100;
  backdrop-filter: blur(10px);
  background: rgba(250, 248, 243, 0.85);
}

.site-header__nav {
  display: flex;
  align-items: center;
  justify-content: space-between;
}

.site-logo {
  display: inline-flex;
  align-items: center;
  gap: 12px;
  text-decoration: none;
  color: var(--color-ink);
  font-family: var(--font-display);
  font-weight: 500;
  font-size: 20px;
  letter-spacing: -0.02em;
}
.site-logo:hover { color: var(--color-ink); }

.site-logo__mark {
  width: 36px;
  height: 36px;
  background: var(--color-terminal-bg);
  border-radius: 7px;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  gap: 2px;
  font-family: var(--font-mono);
  font-weight: 600;
  font-size: 15px;
  color: var(--color-terminal-green);
  padding-right: 2px;
}
.site-logo__chevron { line-height: 1; }
.site-logo__cursor {
  display: inline-block;
  width: 8px;
  height: 13px;
  background: var(--color-terminal-green);
  animation: blink 1.1s infinite;
}

@keyframes blink {
  0%, 50% { opacity: 1; }
  51%, 100% { opacity: 0; }
}

.site-nav {
  display: flex;
  gap: var(--space-6);
  align-items: center;
}
.site-nav a {
  color: var(--color-ink-soft);
  text-decoration: none;
  font-size: 15px;
  font-weight: 500;
}
.site-nav a:hover { color: var(--color-accent); }


/* ==========================================================================
   7. BUTTONS
   ========================================================================== */

.btn {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  padding: 10px 18px;
  border-radius: var(--radius-md);
  font-family: var(--font-body);
  font-size: 14px;
  font-weight: 500;
  text-decoration: none;
  border: none;
  cursor: pointer;
  transition: all var(--dur-fast) var(--ease);
  line-height: 1;
}

.btn-primary {
  background: var(--color-ink);
  color: white;
}
.btn-primary:hover {
  background: var(--color-accent);
  color: white;
}

.btn-ghost {
  background: transparent;
  color: var(--color-ink);
}
.btn-ghost:hover { color: var(--color-accent); }

.btn-accent {
  background: var(--color-terminal-green);
  color: var(--color-ink);
  font-weight: 600;
}
.btn-accent:hover { background: white; }

.btn-lg { padding: 14px 22px; font-size: 15px; }


/* ==========================================================================
   8. CARDS
   Generic card used for articles, content blocks, etc.
   ========================================================================== */

.card {
  background: var(--color-surface);
  border: 1px solid var(--color-rule);
  border-radius: var(--radius-lg);
  overflow: hidden;
  transition: all var(--dur) var(--ease);
}
.card:hover {
  transform: translateY(-3px);
  box-shadow: var(--shadow-lg);
  border-color: var(--color-ink);
}
.card--flat:hover {
  transform: none;
  box-shadow: none;
  border-color: var(--color-rule);
}

a.card { text-decoration: none; color: inherit; display: flex; flex-direction: column; }

.card__body {
  padding: var(--space-5) var(--space-6) var(--space-6);
  flex: 1;
  display: flex;
  flex-direction: column;
}

.card__meta {
  display: flex;
  gap: var(--space-3);
  align-items: center;
  font-family: var(--font-mono);
  font-size: 11px;
  color: var(--color-ink-mute);
  letter-spacing: 0.02em;
  margin-bottom: var(--space-3);
}

.card__tag {
  background: var(--color-accent-soft);
  color: var(--color-accent);
  padding: 3px 8px;
  border-radius: 3px;
  font-weight: 500;
}

.card__title {
  font-family: var(--font-display);
  font-size: 22px;
  font-weight: 500;
  letter-spacing: -0.02em;
  line-height: 1.2;
  margin-bottom: var(--space-3);
  color: var(--color-ink);
}

.card__excerpt {
  color: var(--color-ink-soft);
  font-size: 14px;
  line-height: 1.55;
  flex: 1;
}


/* ==========================================================================
   9. TERMINAL
   Reusable terminal-styled block. Use as decoration, code display, or
   article visual. Include a <div class="terminal-bar"> for the macOS-
   style title bar, then <div class="terminal-body"> for content.
   ========================================================================== */

.terminal {
  background: var(--color-terminal-bg);
  border-radius: var(--radius-lg);
  overflow: hidden;
  box-shadow: var(--shadow-xl);
  font-family: var(--font-mono);
  font-size: 13px;
  line-height: 1.7;
}
.terminal--tilt { transform: rotate(0.5deg); }

.terminal-bar {
  background: var(--color-terminal-bar);
  padding: 12px 16px;
  display: flex;
  align-items: center;
  gap: var(--space-2);
}
.terminal-bar__dot {
  width: 12px;
  height: 12px;
  border-radius: 50%;
}
.terminal-bar__dot--r { background: #ff5f56; }
.terminal-bar__dot--y { background: #ffbd2e; }
.terminal-bar__dot--g { background: #27c93f; }
.terminal-bar__title {
  margin-left: 12px;
  color: var(--color-terminal-mute);
  font-size: 12px;
}

.terminal-body {
  padding: 20px 24px;
  color: var(--color-terminal-ink);
}

/* Terminal text utility classes */
.term-prompt { color: var(--color-terminal-green); }
.term-comment { color: var(--color-terminal-mute); }
.term-output { color: var(--color-terminal-ink); opacity: 0.85; }
.term-key { color: var(--color-terminal-amber); }
.term-error { color: var(--color-terminal-red); }
.term-success { color: var(--color-terminal-green); }

.term-cursor {
  display: inline-block;
  width: 8px;
  height: 15px;
  background: var(--color-terminal-green);
  vertical-align: text-bottom;
  animation: blink 1.1s infinite;
}

/* Compact terminal used as visual header on article cards */
.terminal-visual {
  height: 160px;
  background: var(--color-terminal-bg);
  padding: 20px;
  font-family: var(--font-mono);
  font-size: 12px;
  color: var(--color-terminal-ink);
  line-height: 1.6;
  position: relative;
  overflow: hidden;
}
.terminal-visual::before {
  content: '';
  position: absolute;
  inset: 0;
  background: linear-gradient(180deg, transparent 60%, var(--color-terminal-bg) 100%);
  pointer-events: none;
}


/* ==========================================================================
   10. ARTICLE CONTENT (Prose)
   Apply .prose to article body containers for readable long-form content.
   ========================================================================== */

.prose {
  max-width: 680px;
  margin: 0 auto;
  font-size: 17px;
  line-height: 1.75;
  color: var(--color-ink);
}

.prose > * + * { margin-top: 1.25em; }

.prose h2 {
  font-size: 28px;
  margin-top: 2em;
  margin-bottom: 0.6em;
}
.prose h3 {
  font-size: 22px;
  margin-top: 1.8em;
  margin-bottom: 0.5em;
}
.prose h4 {
  font-size: 18px;
  margin-top: 1.6em;
  margin-bottom: 0.5em;
}

.prose p { margin: 0; }

.prose ul, .prose ol {
  padding-left: 1.5em;
}
.prose li { margin-bottom: 0.4em; }

.prose a {
  color: var(--color-accent);
  border-bottom: 1px solid var(--color-accent-soft);
  transition: border-color var(--dur-fast) var(--ease);
}
.prose a:hover { border-bottom-color: var(--color-accent); }

.prose img {
  border-radius: var(--radius-lg);
  margin: 1.5em auto;
}

.prose blockquote {
  font-size: 18px;
  margin: 1.5em 0;
}

/* Callout box — useful for exam-prep pull quotes and warnings */
.callout {
  background: var(--color-accent-soft);
  border-left: 3px solid var(--color-accent);
  padding: var(--space-5) var(--space-6);
  border-radius: var(--radius-sm);
  margin: var(--space-6) 0;
  color: var(--color-ink);
}
.callout__label {
  font-family: var(--font-mono);
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--color-accent);
  font-weight: 600;
  margin-bottom: var(--space-2);
}


/* ==========================================================================
   11. FORMS
   ========================================================================== */

.form-input {
  background: var(--color-surface);
  border: 1px solid var(--color-rule);
  padding: 12px 16px;
  border-radius: var(--radius-md);
  color: var(--color-ink);
  font-family: var(--font-body);
  font-size: 14px;
  width: 100%;
  outline: none;
  transition: border-color var(--dur-fast) var(--ease);
}
.form-input::placeholder { color: var(--color-ink-mute); }
.form-input:focus { border-color: var(--color-accent); }

/* Dark-surface input used inside the lead-magnet card */
.form-input--dark {
  background: rgba(255,255,255,0.08);
  border-color: rgba(255,255,255,0.15);
  color: white;
}
.form-input--dark::placeholder { color: rgba(255,255,255,0.4); }
.form-input--dark:focus { border-color: var(--color-terminal-green); }


/* ==========================================================================
   12. LEAD MAGNET (Cheat sheet block)
   ========================================================================== */

.lead-magnet {
  background: var(--color-ink);
  color: white;
  border-radius: var(--radius-xl);
  padding: var(--space-7) 56px;
  display: grid;
  grid-template-columns: 1fr auto;
  gap: var(--space-7);
  align-items: center;
  position: relative;
  overflow: hidden;
}
.lead-magnet::before {
  content: '';
  position: absolute;
  top: -40px;
  right: -40px;
  width: 240px;
  height: 240px;
  background: radial-gradient(circle, var(--color-accent) 0%, transparent 70%);
  opacity: 0.3;
}
.lead-magnet__content { position: relative; }
.lead-magnet__label {
  font-family: var(--font-mono);
  font-size: 12px;
  color: var(--color-terminal-green);
  letter-spacing: 0.05em;
  text-transform: uppercase;
  margin-bottom: var(--space-3);
}
.lead-magnet__title {
  font-family: var(--font-display);
  font-size: 32px;
  font-weight: 500;
  letter-spacing: -0.025em;
  line-height: 1.15;
  margin-bottom: var(--space-3);
}
.lead-magnet__sub {
  color: rgba(255,255,255,0.7);
  font-size: 15px;
}
.lead-magnet__form {
  display: flex;
  gap: var(--space-2);
  position: relative;
}
.lead-magnet__form .form-input { width: 240px; }


/* ==========================================================================
   13. FOOTER
   ========================================================================== */

.site-footer {
  background: var(--color-ink);
  color: rgba(255,255,255,0.6);
  padding: var(--space-7) 0;
  font-size: 13px;
}
.site-footer__grid {
  display: flex;
  justify-content: space-between;
  flex-wrap: wrap;
  gap: var(--space-5);
}
.site-footer__links {
  display: flex;
  gap: 28px;
}
.site-footer__links a {
  color: rgba(255,255,255,0.7);
  text-decoration: none;
}
.site-footer__links a:hover { color: white; }
.site-footer__disclaimer {
  margin-top: var(--space-5);
  padding-top: var(--space-5);
  border-top: 1px solid rgba(255,255,255,0.1);
  font-size: 12px;
  color: rgba(255,255,255,0.4);
}


/* ==========================================================================
   14. UTILITIES
   ========================================================================== */

.text-center { text-align: center; }
.text-mute { color: var(--color-ink-mute); }
.text-soft { color: var(--color-ink-soft); }
.text-mono { font-family: var(--font-mono); }
.text-display { font-family: var(--font-display); }

.mb-0 { margin-bottom: 0; }
.mb-1 { margin-bottom: var(--space-2); }
.mb-2 { margin-bottom: var(--space-4); }
.mb-3 { margin-bottom: var(--space-5); }
.mb-4 { margin-bottom: var(--space-6); }
.mb-5 { margin-bottom: var(--space-7); }

.mt-0 { margin-top: 0; }
.mt-1 { margin-top: var(--space-2); }
.mt-2 { margin-top: var(--space-4); }
.mt-3 { margin-top: var(--space-5); }
.mt-4 { margin-top: var(--space-6); }
.mt-5 { margin-top: var(--space-7); }

.visually-hidden {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}


/* ==========================================================================
   15. RESPONSIVE
   ========================================================================== */

@media (max-width: 900px) {
  :root {
    --container-padding: 20px;
  }
  section { padding: var(--space-7) 0; }

  .section-head {
    flex-direction: column;
    gap: var(--space-3);
  }
  .section-head__aside { text-align: left; }

  .site-nav { display: none; }
  .site-nav--mobile { display: flex; } /* enable with JS or :target if needed */

  .lead-magnet {
    grid-template-columns: 1fr;
    padding: var(--space-6);
  }
  .lead-magnet__form {
    width: 100%;
    flex-direction: column;
  }
  .lead-magnet__form .form-input { width: 100%; }
}


/* ==========================================================================
   16. PRINT (article reading, accessibility)
   ========================================================================== */

@media print {
  .site-header, .site-footer, .lead-magnet { display: none; }
  body { background: white; color: black; }
  .prose { max-width: none; }
}