/* ============================================
   HoxCore Documentation - Main Stylesheet
   ============================================ */

/* ============================================
   CSS Variables (Design Tokens)
   ============================================ */
:root {
  /* Colors - Primary Palette */
  --color-primary: #2563eb;
  --color-primary-dark: #1e40af;
  --color-primary-light: #3b82f6;
  --color-secondary: #10b981;
  --color-secondary-dark: #059669;
  --color-accent: #f59e0b;
  
  /* Colors - Neutrals */
  --color-background: #ffffff;
  --color-surface: #f9fafb;
  --color-surface-dark: #f3f4f6;
  --color-border: #e5e7eb;
  --color-text: #1f2937;
  --color-text-light: #6b7280;
  --color-text-muted: #9ca3af;
  
  /* Colors - Semantic */
  --color-success: #10b981;
  --color-warning: #f59e0b;
  --color-error: #ef4444;
  --color-info: #3b82f6;
  
  /* Typography */
  --font-family-base: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
  --font-family-mono: 'Fira Code', 'Courier New', monospace;
  --font-size-base: 16px;
  --font-size-sm: 0.875rem;
  --font-size-lg: 1.125rem;
  --font-size-xl: 1.25rem;
  --font-size-2xl: 1.5rem;
  --font-size-3xl: 1.875rem;
  --font-size-4xl: 2.25rem;
  --line-height-base: 1.6;
  --line-height-tight: 1.4;
  --line-height-loose: 1.8;
  
  /* Spacing */
  --spacing-xs: 0.25rem;
  --spacing-sm: 0.5rem;
  --spacing-md: 1rem;
  --spacing-lg: 1.5rem;
  --spacing-xl: 2rem;
  --spacing-2xl: 3rem;
  --spacing-3xl: 4rem;
  
  /* Layout */
  --container-max-width: 1200px;
  --sidebar-width: 280px;
  --header-height: 70px;
  
  /* Borders */
  --border-radius-sm: 4px;
  --border-radius-md: 8px;
  --border-radius-lg: 12px;
  --border-width: 1px;
  
  /* Shadows */
  --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
  --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
  --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1);
  --shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1);
  
  /* Transitions */
  --transition-fast: 150ms ease-in-out;
  --transition-base: 250ms ease-in-out;
  --transition-slow: 350ms ease-in-out;
}

/* Dark Mode Variables */
@media (prefers-color-scheme: dark) {
  :root {
    --color-background: #111827;
    --color-surface: #1f2937;
    --color-surface-dark: #374151;
    --color-border: #374151;
    --color-text: #f9fafb;
    --color-text-light: #d1d5db;
    --color-text-muted: #9ca3af;
  }
}

/* ============================================
   Reset & Base Styles
   ============================================ */
*, *::before, *::after {
  box-sizing: border-box;
  margin: 0;
  padding: 0;
}

html {
  font-size: var(--font-size-base);
  scroll-behavior: smooth;
}

body {
  font-family: var(--font-family-base);
  font-size: var(--font-size-base);
  line-height: var(--line-height-base);
  color: var(--color-text);
  background-color: var(--color-background);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}

/* ============================================
   Typography
   ============================================ */
h1, h2, h3, h4, h5, h6 {
  font-weight: 700;
  line-height: var(--line-height-tight);
  margin-bottom: var(--spacing-md);
  color: var(--color-text);
}

h1 { font-size: var(--font-size-4xl); }
h2 { font-size: var(--font-size-3xl); }
h3 { font-size: var(--font-size-2xl); }
h4 { font-size: var(--font-size-xl); }
h5 { font-size: var(--font-size-lg); }
h6 { font-size: var(--font-size-base); }

p {
  margin-bottom: var(--spacing-md);
  color: var(--color-text-light);
}

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

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

strong, b {
  font-weight: 600;
}

em, i {
  font-style: italic;
}

code {
  font-family: var(--font-family-mono);
  font-size: 0.9em;
  background-color: var(--color-surface);
  padding: 0.2em 0.4em;
  border-radius: var(--border-radius-sm);
  border: 1px solid var(--color-border);
}

pre {
  font-family: var(--font-family-mono);
  font-size: var(--font-size-sm);
  background-color: var(--color-surface-dark);
  padding: var(--spacing-lg);
  border-radius: var(--border-radius-md);
  overflow-x: auto;
  margin-bottom: var(--spacing-lg);
  border: 1px solid var(--color-border);
}

pre code {
  background: none;
  padding: 0;
  border: none;
  font-size: inherit;
}

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

li {
  margin-bottom: var(--spacing-sm);
  color: var(--color-text-light);
}

blockquote {
  border-left: 4px solid var(--color-primary);
  padding-left: var(--spacing-lg);
  margin: var(--spacing-lg) 0;
  font-style: italic;
  color: var(--color-text-light);
}

/* ============================================
   Layout Components
   ============================================ */
.container {
  max-width: var(--container-max-width);
  margin: 0 auto;
  padding: 0 var(--spacing-lg);
}

/* ============================================
   Navigation Bar
   ============================================ */
.navbar {
  background-color: var(--color-background);
  border-bottom: 1px solid var(--color-border);
  position: sticky;
  top: 0;
  z-index: 1000;
  height: var(--header-height);
  box-shadow: var(--shadow-sm);
}

.navbar .container {
  display: flex;
  align-items: center;
  justify-content: space-between;
  height: 100%;
}

.nav-brand {
  font-size: var(--font-size-xl);
  font-weight: 700;
  color: var(--color-primary);
}

.nav-brand .logo {
  display: inline-block;
  transition: transform var(--transition-fast);
}

.nav-brand:hover .logo {
  transform: scale(1.05);
}

.nav-menu {
  display: flex;
  list-style: none;
  gap: var(--spacing-lg);
  align-items: center;
  padding: 0;
  margin: 0;
}

.nav-menu li {
  margin: 0;
}

.nav-menu a {
  color: var(--color-text);
  font-weight: 500;
  padding: var(--spacing-sm) var(--spacing-md);
  border-radius: var(--border-radius-sm);
  transition: all var(--transition-fast);
}

.nav-menu a:hover {
  background-color: var(--color-surface);
  text-decoration: none;
}

.nav-menu a.active {
  color: var(--color-primary);
  background-color: var(--color-surface);
}

.nav-menu .github-link {
  background-color: var(--color-text);
  color: var(--color-background);
  padding: var(--spacing-sm) var(--spacing-lg);
  border-radius: var(--border-radius-md);
}

.nav-menu .github-link:hover {
  background-color: var(--color-text-light);
  transform: translateY(-2px);
}

/* Mobile Navigation Toggle */
.nav-toggle {
  display: none;
  flex-direction: column;
  gap: 4px;
  background: none;
  border: none;
  cursor: pointer;
  padding: var(--spacing-sm);
}

.nav-toggle span {
  width: 24px;
  height: 2px;
  background-color: var(--color-text);
  transition: all var(--transition-fast);
}

/* ============================================
   Hero Section
   ============================================ */
.hero {
  background: linear-gradient(135deg, var(--color-primary) 0%, var(--color-primary-dark) 100%);
  color: white;
  padding: var(--spacing-3xl) 0;
  text-align: center;
}

.hero-content {
  max-width: 800px;
  margin: 0 auto;
}

.hero-title {
  font-size: 3.5rem;
  font-weight: 800;
  margin-bottom: var(--spacing-lg);
  color: white;
}

.hero-subtitle {
  font-size: var(--font-size-2xl);
  font-weight: 600;
  margin-bottom: var(--spacing-md);
  color: rgba(255, 255, 255, 0.95);
}

.hero-description {
  font-size: var(--font-size-lg);
  line-height: var(--line-height-loose);
  margin-bottom: var(--spacing-2xl);
  color: rgba(255, 255, 255, 0.9);
}

.hero-buttons {
  display: flex;
  gap: var(--spacing-lg);
  justify-content: center;
  flex-wrap: wrap;
  margin-bottom: var(--spacing-2xl);
}

.hero-install {
  background-color: rgba(0, 0, 0, 0.2);
  padding: var(--spacing-lg);
  border-radius: var(--border-radius-md);
  max-width: 500px;
  margin: 0 auto;
}

.hero-install pre {
  background-color: rgba(0, 0, 0, 0.3);
  margin: 0;
  text-align: left;
}

/* ============================================
   Buttons
   ============================================ */
.btn {
  display: inline-block;
  padding: var(--spacing-md) var(--spacing-xl);
  font-size: var(--font-size-base);
  font-weight: 600;
  text-align: center;
  border-radius: var(--border-radius-md);
  transition: all var(--transition-fast);
  cursor: pointer;
  border: 2px solid transparent;
  text-decoration: none;
}

.btn-primary {
  background-color: white;
  color: var(--color-primary);
  border-color: white;
}

.btn-primary:hover {
  background-color: var(--color-surface);
  transform: translateY(-2px);
  box-shadow: var(--shadow-lg);
  text-decoration: none;
}

.btn-secondary {
  background-color: transparent;
  color: white;
  border-color: white;
}

.btn-secondary:hover {
  background-color: rgba(255, 255, 255, 0.1);
  transform: translateY(-2px);
  text-decoration: none;
}

.btn-large {
  padding: var(--spacing-lg) var(--spacing-2xl);
  font-size: var(--font-size-lg);
}

/* ============================================
   Sections
   ============================================ */
.section-title {
  font-size: var(--font-size-3xl);
  text-align: center;
  margin-bottom: var(--spacing-2xl);
  color: var(--color-text);
}

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

section:nth-child(even) {
  background-color: var(--color-surface);
}

/* ============================================
   Feature Cards
   ============================================ */
.features-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
  gap: var(--spacing-xl);
  margin-top: var(--spacing-2xl);
}

.feature-card {
  background-color: var(--color-background);
  padding: var(--spacing-xl);
  border-radius: var(--border-radius-lg);
  border: 1px solid var(--color-border);
  transition: all var(--transition-base);
}

.feature-card:hover {
  transform: translateY(-4px);
  box-shadow: var(--shadow-lg);
  border-color: var(--color-primary);
}

.feature-icon {
  font-size: 3rem;
  margin-bottom: var(--spacing-md);
}

.feature-card h3 {
  color: var(--color-text);
  margin-bottom: var(--spacing-md);
}

.feature-card p {
  color: var(--color-text-light);
  margin-bottom: 0;
}

/* ============================================
   Quick Start Section
   ============================================ */
.quick-start {
  background-color: var(--color-surface);
}

.quick-start-steps {
  max-width: 800px;
  margin: 0 auto;
}

.step {
  display: flex;
  gap: var(--spacing-lg);
  margin-bottom: var(--spacing-2xl);
  align-items: flex-start;
}

.step-number {
  flex-shrink: 0;
  width: 48px;
  height: 48px;
  background-color: var(--color-primary);
  color: white;
  border-radius: 50%;
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: var(--font-size-xl);
  font-weight: 700;
}

.step-content {
  flex: 1;
}

.step-content h3 {
  margin-bottom: var(--spacing-sm);
}

.step-content pre {
  margin-top: var(--spacing-md);
}

.quick-start-cta {
  text-align: center;
  margin-top: var(--spacing-2xl);
}

/* ============================================
   Concepts Section
   ============================================ */
.concepts-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
  gap: var(--spacing-lg);
  margin-bottom: var(--spacing-2xl);
}

.concept-card {
  background-color: var(--color-background);
  padding: var(--spacing-xl);
  border-radius: var(--border-radius-lg);
  border: 2px solid var(--color-border);
  text-align: center;
  transition: all var(--transition-base);
}

.concept-card:hover {
  border-color: var(--color-primary);
  transform: translateY(-4px);
  box-shadow: var(--shadow-md);
}

.concept-card h3 {
  margin-bottom: var(--spacing-md);
}

.concepts-note {
  background-color: var(--color-surface);
  padding: var(--spacing-xl);
  border-radius: var(--border-radius-lg);
  border-left: 4px solid var(--color-primary);
  text-align: center;
}

.concepts-note p {
  margin-bottom: var(--spacing-lg);
}

/* ============================================
   Example Section
   ============================================ */
.example {
  background-color: var(--color-surface-dark);
}

.example-content {
  max-width: 900px;
  margin: 0 auto;
}

.example-cta {
  text-align: center;
  margin-top: var(--spacing-2xl);
}

/* ============================================
   Use Cases Section
   ============================================ */
.use-cases-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
  gap: var(--spacing-xl);
}

.use-case-card {
  background-color: var(--color-background);
  padding: var(--spacing-xl);
  border-radius: var(--border-radius-lg);
  border: 1px solid var(--color-border);
}

.use-case-card h3 {
  color: var(--color-primary);
  margin-bottom: var(--spacing-md);
}

/* ============================================
   Principles Section
   ============================================ */
.principles-list {
  max-width: 900px;
  margin: 0 auto;
}

.principle-item {
  display: flex;
  gap: var(--spacing-lg);
  margin-bottom: var(--spacing-xl);
  padding: var(--spacing-xl);
  background-color: var(--color-background);
  border-radius: var(--border-radius-lg);
  border: 1px solid var(--color-border);
}

.principle-icon {
  font-size: 2.5rem;
  flex-shrink: 0;
}

.principle-content h3 {
  margin-bottom: var(--spacing-sm);
}

.principle-content p {
  margin-bottom: 0;
}

/* ============================================
   CTA Section
   ============================================ */
.cta {
  background: linear-gradient(135deg, var(--color-primary) 0%, var(--color-primary-dark) 100%);
  color: white;
  text-align: center;
}

.cta-content h2 {
  color: white;
  margin-bottom: var(--spacing-md);
}

.cta-content p {
  color: rgba(255, 255, 255, 0.9);
  font-size: var(--font-size-lg);
  margin-bottom: var(--spacing-2xl);
}

.cta-buttons {
  display: flex;
  gap: var(--spacing-lg);
  justify-content: center;
  flex-wrap: wrap;
}

/* ============================================
   Footer
   ============================================ */
.footer {
  background-color: var(--color-surface-dark);
  padding: var(--spacing-3xl) 0 var(--spacing-xl);
  border-top: 1px solid var(--color-border);
}

.footer-content {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
  gap: var(--spacing-2xl);
  margin-bottom: var(--spacing-2xl);
}

.footer-section h3 {
  font-size: var(--font-size-lg);
  margin-bottom: var(--spacing-md);
  color: var(--color-text);
}

.footer-section p {
  color: var(--color-text-light);
  margin-bottom: var(--spacing-md);
}

.footer-section ul {
  list-style: none;
  padding: 0;
  margin: 0;
}

.footer-section ul li {
  margin-bottom: var(--spacing-sm);
}

.footer-section ul li a {
  color: var(--color-text-light);
  transition: color var(--transition-fast);
}

.footer-section ul li a:hover {
  color: var(--color-primary);
  text-decoration: none;
}

.footer-bottom {
  text-align: center;
  padding-top: var(--spacing-xl);
  border-top: 1px solid var(--color-border);
  color: var(--color-text-muted);
}

.footer-bottom p {
  margin-bottom: var(--spacing-sm);
  color: var(--color-text-muted);
}

/* ============================================
   Documentation Layout
   ============================================ */
.page-header {
  background: linear-gradient(135deg, var(--color-primary) 0%, var(--color-primary-dark) 100%);
  color: white;
  padding: var(--spacing-2xl) 0;
  text-align: center;
}

.page-header h1 {
  color: white;
  margin-bottom: var(--spacing-md);
}

.page-header p {
  color: rgba(255, 255, 255, 0.9);
  font-size: var(--font-size-lg);
  margin-bottom: 0;
}

.documentation {
  padding: var(--spacing-3xl) 0;
}

.doc-layout {
  display: grid;
  grid-template-columns: var(--sidebar-width) 1fr;
  gap: var(--spacing-2xl);
  align-items: start;
}

/* ============================================
   Documentation Sidebar
   ============================================ */
.doc-sidebar {
  position: sticky;
  top: calc(var(--header-height) + var(--spacing-lg));
  max-height: calc(100vh - var(--header-height) - var(--spacing-2xl));
  overflow-y: auto;
}

.doc-nav {
  background-color: var(--color-surface);
  padding: var(--spacing-lg);
  border-radius: var(--border-radius-lg);
  border: 1px solid var(--color-border);
}

.doc-nav h3 {
  font-size: var(--font-size-lg);
  margin-bottom: var(--spacing-md);
  color: var(--color-text);
}

.doc-nav ul {
  list-style: none;
  padding: 0;
  margin: 0;
}

.doc-nav ul li {
  margin-bottom: var(--spacing-sm);
}

.doc-nav ul li a {
  display: block;
  padding: var(--spacing-sm) var(--spacing-md);
  color: var(--color-text-light);
  border-radius: var(--border-radius-sm);
  transition: all var(--transition-fast);
}

.doc-nav ul li a:hover {
  background-color: var(--color-surface-dark);
  color: var(--color-primary);
  text-decoration: none;
}

.doc-nav ul li a.active {
  background-color: var(--color-primary);
  color: white;
}

/* ============================================
   Documentation Content
   ============================================ */
.doc-content {
  max-width: 800px;
}

.doc-section {
  margin-bottom: var(--spacing-3xl);
}

.doc-section h2 {
  font-size: var(--font-size-2xl);
  margin-bottom: var(--spacing-lg);
  padding-bottom: var(--spacing-md);
  border-bottom: 2px solid var(--color-border);
}

.doc-section h3 {
  font-size: var(--font-size-xl);
  margin-top: var(--spacing-xl);
  margin-bottom: var(--spacing-md);
}

.doc-section h4 {
  font-size: var(--font-size-lg);
  margin-top: var(--spacing-lg);
  margin-bottom: var(--spacing-md);
}

/* ============================================
   Documentation Tables
   ============================================ */
.doc-table {
  width: 100%;
  border-collapse: collapse;
  margin-bottom: var(--spacing-lg);
  background-color: var(--color-background);
  border: 1px solid var(--color-border);
  border-radius: var(--border-radius-md);
  overflow: hidden;
}

.doc-table thead {
  background-color: var(--color-surface);
}

.doc-table th {
  padding: var(--spacing-md);
  text-align: left;
  font-weight: 600;
  color: var(--color-text);
  border-bottom: 2px solid var(--color-border);
}

.doc-table td {
  padding: var(--spacing-md);
  border-bottom: 1px solid var(--color-border);
  color: var(--color-text-light);
}

.doc-table tbody tr:last-child td {
  border-bottom: none;
}

.doc-table tbody tr:hover {
  background-color: var(--color-surface);
}

.table-note {
  font-size: var(--font-size-sm);
  color: var(--color-text-muted);
  font-style: italic;
  margin-top: var(--spacing-sm);
}

/* ============================================
   Info Boxes
   ============================================ */
.info-box,
.warning-box,
.success-box,
.concept-box {
  padding: var(--spacing-lg);
  border-radius: var(--border-radius-md);
  margin-bottom: var(--spacing-lg);
  border-left: 4px solid;
}

.info-box {
  background-color: rgba(59, 130, 246, 0.1);
  border-color: var(--color-info);
}

.warning-box {
  background-color: rgba(245, 158, 11, 0.1);
  border-color: var(--color-warning);
}

.success-box {
  background-color: rgba(16, 185, 129, 0.1);
  border-color: var(--color-success);
}

.concept-box {
  background-color: var(--color-surface);
  border-color: var(--color-primary);
}

.info-box h4,
.warning-box h4,
.success-box h4,
.concept-box h4 {
  margin-bottom: var(--spacing-md);
  font-size: var(--font-size-lg);
}

.info-box p:last-child,
.warning-box p:last-child,
.success-box p:last-child,
.concept-box p:last-child {
  margin-bottom: 0;
}

/* ============================================
   Next Steps Grid
   ============================================ */
.next-steps-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
  gap: var(--spacing-lg);
  margin-top: var(--spacing-xl);
}

.next-step-card {
  background-color: var(--color-surface);
  padding: var(--spacing-xl);
  border-radius: var(--border-radius-lg);
  border: 1px solid var(--color-border);
  transition: all var(--transition-base);
}

.next-step-card:hover {
  transform: translateY(-4px);
  box-shadow: var(--shadow-md);
  border-color: var(--color-primary);
}

.next-step-card h3 {
  margin-bottom: var(--spacing-md);
  color: var(--color-text);
}

.next-step-card p {
  margin-bottom: var(--spacing-lg);
}

.next-step-card .btn {
  width: 100%;
}

/* ============================================
   Entity Type Cards
   ============================================ */
.entity-types-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
  gap: var(--spacing-xl);
  margin-top: var(--spacing-xl);
}

.entity-type-card {
  background-color: var(--color-background);
  padding: var(--spacing-xl);
  border-radius: var(--border-radius-lg);
  border: 2px solid var(--color-border);
  transition: all var(--transition-base);
}

.entity-type-card:hover {
  border-color: var(--color-primary);
  transform: translateY(-4px);
  box-shadow: var(--shadow-lg);
}

.entity-icon {
  font-size: 3rem;
  margin-bottom: var(--spacing-md);
  text-align: center;
}

.entity-type-card h3 {
  text-align: center;
  margin-bottom: var(--spacing-md);
  color: var(--color-primary);
}

.entity-description {
  text-align: center;
  font-style: italic;
  color: var(--color-text-light);
  margin-bottom: var(--spacing-lg);
}

.entity-details h4 {
  font-size: var(--font-size-base);
  margin-top: var(--spacing-lg);
  margin-bottom: var(--spacing-sm);
  color: var(--color-text);
}

.entity-details ul {
  margin-bottom: var(--spacing-md);
}

/* ============================================
   Status Cards
   ============================================ */
.status-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
  gap: var(--spacing-lg);
  margin: var(--spacing-xl) 0;
}

.status-card {
  padding: var(--spacing-lg);
  border-radius: var(--border-radius-md);
  border: 2px solid;
  text-align: center;
}

.status-card h4 {
  margin-bottom: var(--spacing-sm);
  font-family: var(--font-family-mono);
}

.status-active {
  background-color: rgba(16, 185, 129, 0.1);
  border-color: var(--color-success);
}

.status-completed {
  background-color: rgba(59, 130, 246, 0.1);
  border-color: var(--color-info);
}

.status-on-hold {
  background-color: rgba(245, 158, 11, 0.1);
  border-color: var(--color-warning);
}

.status-canceled {
  background-color: rgba(239, 68, 68, 0.1);
  border-color: var(--color-error);
}

/* ============================================
   Integration Cards
   ============================================ */
.integration-categories {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
  gap: var(--spacing-lg);
  margin: var(--spacing-xl) 0;
}

.category-card {
  background-color: var(--color-surface);
  padding: var(--spacing-lg);
  border-radius: var(--border-radius-md);
  border: 1px solid var(--color-border);
  text-align: center;
}

.category-card h4 {
  margin-bottom: var(--spacing-sm);
  color: var(--color-primary);
}

.integration-detail {
  background-color: var(--color-surface);
  padding: var(--spacing-xl);
  border-radius: var(--border-radius-lg);
  border: 1px solid var(--color-border);
  margin-bottom: var(--spacing-xl);
}

.integration-detail h4 {
  margin-top: var(--spacing-lg);
  margin-bottom: var(--spacing-md);
  color: var(--color-primary);
}

/* ============================================
   Best Practice Sections
   ============================================ */
.best-practice {
  background-color: var(--color-surface);
  padding: var(--spacing-lg);
  border-radius: var(--border-radius-md);
  margin-bottom: var(--spacing-lg);
}

.best-practice h4 {
  margin-bottom: var(--spacing-md);
}

/* ============================================
   Principles Detailed
   ============================================ */
.principles-detailed {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
  gap: var(--spacing-xl);
  margin-top: var(--spacing-xl);
}

.principle-detailed {
  background-color: var(--color-surface);
  padding: var(--spacing-xl);
  border-radius: var(--border-radius-lg);
  border: 1px solid var(--color-border);
}

.principle-detailed h3 {
  margin-bottom: var(--spacing-md);
  color: var(--color-primary);
}

.principle-detailed p {
  font-weight: 600;
  margin-bottom: var(--spacing-md);
}

/* ============================================
   Capabilities Grid
   ============================================ */
.capabilities-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
  gap: var(--spacing-lg);
  margin: var(--spacing-xl) 0;
}

.capability-card {
  background-color: var(--color-surface);
  padding: var(--spacing-lg);
  border-radius: var(--border-radius-md);
  border: 1px solid var(--color-border);
}

.capability-card h4 {
  margin-bottom: var(--spacing-md);
  color: var(--color-primary);
}

.capability-card pre {
  margin-top: var(--spacing-md);
}

/* ============================================
   Translation Example
   ============================================ */
.translation-example {
  display: grid;
  grid-template-columns: 1fr auto 1fr;
  gap: var(--spacing-lg);
  align-items: center;
  margin: var(--spacing-xl) 0;
  padding: var(--spacing-xl);
  background-color: var(--color-surface);
  border-radius: var(--border-radius-lg);
}

.translation-input,
.translation-output {
  background-color: var(--color-background);
  padding: var(--spacing-lg);
  border-radius: var(--border-radius-md);
  border: 1px solid var(--color-border);
}

.translation-arrow {
  font-size: var(--font-size-2xl);
  color: var(--color-primary);
  font-weight: bold;
}

/* ============================================
   Provider Cards
   ============================================ */
.provider-card {
  background-color: var(--color-surface);
  padding: var(--spacing-xl);
  border-radius: var(--border-radius-lg);
  border: 1px solid var(--color-border);
  margin-bottom: var(--spacing-xl);
}

.provider-card h4 {
  margin-bottom: var(--spacing-md);
  color: var(--color-primary);
}

/* ============================================
   Use Case Examples
   ============================================ */
.use-case-example {
  background-color: var(--color-surface);
  padding: var(--spacing-xl);
  border-radius: var(--border-radius-lg);
  border: 1px solid var(--color-border);
  margin-bottom: var(--spacing-xl);
}

.use-case-example h4 {
  margin-bottom: var(--spacing-md);
  color: var(--color-primary);
}

/* ============================================
   Responsive Design
   ============================================ */
@media (max-width: 1024px) {
  .doc-layout {
    grid-template-columns: 1fr;
  }
  
  .doc-sidebar {
    position: static;
    max-height: none;
    margin-bottom: var(--spacing-xl);
  }
}

@media (max-width: 768px) {
  :root {
    --font-size-base: 15px;
    --spacing-3xl: 2rem;
  }
  
  .nav-menu {
    display: none;
    position: absolute;
    top: var(--header-height);
    left: 0;
    right: 0;
    background-color: var(--color-background);
    flex-direction: column;
    padding: var(--spacing-lg);
    border-bottom: 1px solid var(--color-border);
    box-shadow: var(--shadow-lg);
  }
  
  .nav-menu.active {
    display: flex;
  }
  
  .nav-toggle {
    display: flex;
  }
  
  .hero-title {
    font-size: 2.5rem;
  }
  
  .hero-subtitle {
    font-size: var(--font-size-xl);
  }
  
  .hero-buttons {
    flex-direction: column;
  }
  
  .features-grid,
  .concepts-grid,
  .use-cases-grid,
  .next-steps-grid,
  .entity-types-grid,
  .principles-detailed,
  .capabilities-grid {
    grid-template-columns: 1fr;
  }
  
  .step {
    flex-direction: column;
  }
  
  .translation-example {
    grid-template-columns: 1fr;
  }
  
  .translation-arrow {
    transform: rotate(90deg);
    text-align: center;
  }
  
  .footer-content {
    grid-template-columns: 1fr;
  }
}

@media (max-width: 480px) {
  :root {
    --font-size-base: 14px;
    --spacing-lg: 1rem;
    --spacing-xl: 1.5rem;
    --spacing-2xl: 2rem;
  }
  
  .container {
    padding: 0 var(--spacing-md);
  }
  
  .hero-title {
    font-size: 2rem;
  }
  
  .btn {
    width: 100%;
  }
  
  .doc-table {
    font-size: var(--font-size-sm);
  }
  
  .doc-table th,
  .doc-table td {
    padding: var(--spacing-sm);
  }
}

/* ============================================
   Print Styles
   ============================================ */
@media print {
  .navbar,
  .footer,
  .doc-sidebar,
  .hero-buttons,
  .cta,
  .next-steps-grid {
    display: none;
  }
  
  body {
    font-size: 12pt;
    line-height: 1.5;
    color: #000;
    background: #fff;
  }
  
  .doc-content {
    max-width: 100%;
  }
  
  pre {
    border: 1px solid #ccc;
    page-break-inside: avoid;
  }
  
  h2, h3, h4 {
    page-break-after: avoid;
  }
}

/* ============================================
   Accessibility
   ============================================ */
.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border-width: 0;
}

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

/* ============================================
   Animations
   ============================================ */
@keyframes fadeIn {
  from {
    opacity: 0;
    transform: translateY(20px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

.fade-in {
  animation: fadeIn var(--transition-base) ease-out;
}

/* ============================================
   Utility Classes
   ============================================ */
.text-center {
  text-align: center;
}

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

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

.mt-0 { margin-top: 0; }
.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); }

.mb-0 { margin-bottom: 0; }
.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); }

.hidden {
  display: none;
}

.visible {
  display: block;
}

/* ============================================
   End of Stylesheet
   ============================================ */