/* HLMS Documentation Stylesheet
   Version: 1.0.0
   Theme: Purple gradient matching main app
*/

/* ==========================================
   CSS Variables (Design Tokens)
   ========================================== */
:root {
    /* Brand Colors */
    --primary-start: #667eea;
    --primary-end: #764ba2;
    --primary-gradient: linear-gradient(135deg, var(--primary-start), var(--primary-end));
    
    /* Status Colors */
    --color-success: #10b981;
    --color-warning: #f59e0b;
    --color-error: #ef4444;
    --color-info: #3b82f6;
    
    /* Neutral Colors */
    --color-white: #ffffff;
    --color-gray-50: #f9fafb;
    --color-gray-100: #f3f4f6;
    --color-gray-200: #e5e7eb;
    --color-gray-300: #d1d5db;
    --color-gray-400: #9ca3af;
    --color-gray-500: #6b7280;
    --color-gray-600: #4b5563;
    --color-gray-700: #374151;
    --color-gray-800: #1f2937;
    --color-gray-900: #111827;
    
    /* Typography */
    --font-sans: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
    --font-mono: 'SF Mono', Monaco, 'Cascadia Code', 'Courier New', monospace;
    
    /* Spacing */
    --space-xs: 0.25rem;
    --space-sm: 0.5rem;
    --space-md: 1rem;
    --space-lg: 1.5rem;
    --space-xl: 2rem;
    --space-2xl: 3rem;
    
    /* Border Radius */
    --radius-sm: 0.25rem;
    --radius-md: 0.5rem;
    --radius-lg: 1rem;
    --radius-xl: 1.5rem;
    
    /* Shadows */
    --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.05);
    --shadow-md: 0 4px 6px rgba(0, 0, 0, 0.1);
    --shadow-lg: 0 10px 15px rgba(0, 0, 0, 0.1);
    
    /* Layout */
    --nav-height: 60px;
    --sidebar-width: 250px;
    --content-max-width: 800px;
}

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

html {
    font-size: 16px;
    scroll-behavior: smooth;
}

body {
    font-family: var(--font-sans);
    line-height: 1.6;
    color: var(--color-gray-800);
    background: var(--color-gray-50);
}

/* Accessibility: Skip Link */
.skip-link {
    position: absolute;
    top: -40px;
    left: 0;
    padding: var(--space-sm) var(--space-md);
    background: var(--primary-start);
    color: white;
    z-index: 1000;
}

.skip-link:focus {
    top: 0;
}

/* ==========================================
   Navigation
   ========================================== */
.docs-nav {
    position: fixed;
    top: 0;
    left: 0;
    right: 0;
    height: var(--nav-height);
    background: var(--color-white);
    border-bottom: 1px solid var(--color-gray-200);
    display: flex;
    align-items: center;
    padding: 0 var(--space-lg);
    z-index: 100;
    gap: var(--space-lg);
}

.nav-brand a {
    display: flex;
    align-items: center;
    gap: var(--space-sm);
    text-decoration: none;
    color: var(--color-gray-800);
    font-weight: 600;
}

.nav-logo {
    font-size: 1.5rem;
}

.nav-search {
    flex: 1;
    max-width: 400px;
    position: relative;
}

.nav-search input {
    width: 100%;
    padding: var(--space-sm) var(--space-md);
    border: 1px solid var(--color-gray-300);
    border-radius: var(--radius-lg);
    font-size: 0.9rem;
}

.nav-search input:focus {
    outline: none;
    border-color: var(--primary-start);
    box-shadow: 0 0 0 3px rgba(102, 126, 234, 0.2);
}

.search-results {
    position: absolute;
    top: 100%;
    left: 0;
    right: 0;
    background: var(--color-white);
    border: 1px solid var(--color-gray-200);
    border-radius: var(--radius-md);
    box-shadow: var(--shadow-lg);
    max-height: 400px;
    overflow-y: auto;
    margin-top: var(--space-xs);
}

.nav-links {
    display: flex;
    gap: var(--space-md);
}

.nav-link {
    text-decoration: none;
    color: var(--color-gray-600);
    padding: var(--space-sm) var(--space-md);
    border-radius: var(--radius-md);
    transition: all 0.2s;
}

.nav-link:hover {
    background: var(--color-gray-100);
    color: var(--color-gray-800);
}

.nav-link.active {
    background: var(--primary-gradient);
    color: var(--color-white);
}

.nav-menu-toggle {
    display: none;
    background: none;
    border: none;
    font-size: 1.5rem;
    cursor: pointer;
}

/* ==========================================
   Sidebar
   ========================================== */
.docs-sidebar {
    position: fixed;
    top: var(--nav-height);
    left: 0;
    width: var(--sidebar-width);
    height: calc(100vh - var(--nav-height));
    background: var(--color-white);
    border-right: 1px solid var(--color-gray-200);
    overflow-y: auto;
    padding: var(--space-lg);
}

.sidebar-title {
    font-size: 0.875rem;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    color: var(--color-gray-500);
    margin-bottom: var(--space-md);
}

.sidebar-links {
    list-style: none;
}

.sidebar-links li {
    margin-bottom: var(--space-xs);
}

.sidebar-links a {
    display: block;
    padding: var(--space-sm) var(--space-md);
    color: var(--color-gray-600);
    text-decoration: none;
    border-radius: var(--radius-md);
    transition: all 0.2s;
}

.sidebar-links a:hover {
    background: var(--color-gray-100);
    color: var(--color-gray-800);
}

.sidebar-links a.active {
    background: rgba(102, 126, 234, 0.1);
    color: var(--primary-start);
    font-weight: 500;
}

/* ==========================================
   Main Content
   ========================================== */
.docs-content {
    margin-left: var(--sidebar-width);
    margin-top: var(--nav-height);
    padding: var(--space-2xl);
    min-height: calc(100vh - var(--nav-height));
}

.page-content {
    max-width: var(--content-max-width);
    margin: 0 auto;
}

/* Breadcrumb */
.breadcrumb ol {
    display: flex;
    list-style: none;
    gap: var(--space-sm);
    font-size: 0.875rem;
    color: var(--color-gray-500);
    margin-bottom: var(--space-md);
}

.breadcrumb li::after {
    content: '/';
    margin-left: var(--space-sm);
}

.breadcrumb li:last-child::after {
    content: '';
}

.breadcrumb a {
    color: var(--color-gray-500);
    text-decoration: none;
}

.breadcrumb a:hover {
    color: var(--primary-start);
}

/* Page Header */
.page-header {
    margin-bottom: var(--space-2xl);
}

.page-header h1 {
    font-size: 2.5rem;
    font-weight: 700;
    color: var(--color-gray-900);
    margin-bottom: var(--space-sm);
}

.page-description {
    font-size: 1.25rem;
    color: var(--color-gray-600);
}

/* ==========================================
   Content Typography
   ========================================== */
.page-content h2 {
    font-size: 1.75rem;
    margin-top: var(--space-2xl);
    margin-bottom: var(--space-md);
    color: var(--color-gray-800);
}

.page-content h3 {
    font-size: 1.25rem;
    margin-top: var(--space-xl);
    margin-bottom: var(--space-sm);
    color: var(--color-gray-700);
}

.page-content p {
    margin-bottom: var(--space-md);
}

.page-content ul, .page-content ol {
    margin-bottom: var(--space-md);
    padding-left: var(--space-xl);
}

.page-content li {
    margin-bottom: var(--space-sm);
}

/* Code blocks */
.page-content code {
    font-family: var(--font-mono);
    font-size: 0.9em;
    background: var(--color-gray-100);
    padding: 0.1em 0.3em;
    border-radius: var(--radius-sm);
}

.page-content pre {
    background: var(--color-gray-800);
    color: var(--color-gray-100);
    padding: var(--space-md);
    border-radius: var(--radius-md);
    overflow-x: auto;
    margin-bottom: var(--space-md);
}

.page-content pre code {
    background: none;
    padding: 0;
}

/* ==========================================
   Screenshot Placeholders
   ========================================== */
.screenshot {
    margin: var(--space-lg) 0;
}

.screenshot-placeholder {
    background: var(--color-gray-100);
    border: 2px dashed var(--color-gray-300);
    border-radius: var(--radius-lg);
    padding: var(--space-2xl);
    text-align: center;
    color: var(--color-gray-500);
    font-size: 1.25rem;
}

.screenshot img {
    max-width: 100%;
    border-radius: var(--radius-lg);
    box-shadow: var(--shadow-md);
}

.screenshot figcaption {
    text-align: center;
    font-size: 0.875rem;
    color: var(--color-gray-500);
    margin-top: var(--space-sm);
    font-style: italic;
}

/* ==========================================
   Step Boxes (Student Pages)
   ========================================== */
.step-box {
    background: var(--color-white);
    border-radius: var(--radius-xl);
    padding: var(--space-xl);
    margin-bottom: var(--space-lg);
    box-shadow: var(--shadow-sm);
    border-left: 4px solid var(--primary-start);
}

.step-number {
    display: inline-block;
    background: var(--primary-gradient);
    color: var(--color-white);
    font-weight: 700;
    font-size: 0.875rem;
    padding: var(--space-xs) var(--space-md);
    border-radius: var(--radius-lg);
    margin-bottom: var(--space-sm);
}

.step-title {
    font-size: 1.5rem;
    margin-bottom: var(--space-sm);
    color: var(--color-gray-800);
}

.step-text {
    font-size: 1.125rem;
    color: var(--color-gray-600);
    margin-bottom: var(--space-md);
}

/* ==========================================
   Tip Boxes
   ========================================== */
.tip-box {
    display: flex;
    gap: var(--space-md);
    background: rgba(102, 126, 234, 0.1);
    border-radius: var(--radius-lg);
    padding: var(--space-lg);
    margin: var(--space-xl) 0;
}

.tip-icon {
    font-size: 1.5rem;
}

.tip-text {
    flex: 1;
    color: var(--color-gray-700);
}

/* Warning boxes */
.warning-box {
    display: flex;
    gap: var(--space-md);
    background: rgba(245, 158, 11, 0.1);
    border-left: 4px solid var(--color-warning);
    border-radius: var(--radius-md);
    padding: var(--space-lg);
    margin: var(--space-xl) 0;
}

/* ==========================================
   Glossary Terms (Auto-linked)
   ========================================== */
[data-glossary] {
    border-bottom: 1px dotted var(--primary-start);
    cursor: help;
    position: relative;
}

[data-glossary]:hover::after {
    content: attr(data-definition);
    position: absolute;
    bottom: 100%;
    left: 50%;
    transform: translateX(-50%);
    background: var(--color-gray-800);
    color: var(--color-white);
    padding: var(--space-sm) var(--space-md);
    border-radius: var(--radius-md);
    font-size: 0.875rem;
    white-space: nowrap;
    max-width: 300px;
    z-index: 10;
}

/* ==========================================
   Page Footer
   ========================================== */
.page-footer {
    margin-top: var(--space-2xl);
    padding-top: var(--space-lg);
    border-top: 1px solid var(--color-gray-200);
}

.page-footer hr {
    display: none;
}

.related-pages h3 {
    font-size: 1rem;
    color: var(--color-gray-600);
    margin-bottom: var(--space-sm);
}

.related-pages ul {
    list-style: none;
    display: flex;
    gap: var(--space-md);
    flex-wrap: wrap;
}

.related-pages a {
    color: var(--primary-start);
    text-decoration: none;
}

.related-pages a:hover {
    text-decoration: underline;
}

.page-meta {
    margin-top: var(--space-lg);
    color: var(--color-gray-500);
    font-size: 0.875rem;
}

/* ==========================================
   Student-Specific Styles
   ========================================== */
.audience-student {
    --font-size-base: 1.125rem;
}

.audience-student .docs-content {
    margin-left: 0;
    padding: var(--space-lg);
}

.student-nav {
    justify-content: space-between;
    background: var(--primary-gradient);
}

.student-nav a {
    color: var(--color-white);
    text-decoration: none;
    font-weight: 600;
}

.student-nav .nav-title {
    color: var(--color-white);
    font-weight: 700;
}

.student-content {
    max-width: 700px;
    margin: 0 auto;
}

.student-content .page-header h1 {
    font-size: 2rem;
    text-align: center;
}

.student-content .page-tagline {
    text-align: center;
    font-size: 1.25rem;
    color: var(--color-gray-600);
}

/* Page navigation for students */
.page-nav {
    display: flex;
    justify-content: space-between;
    align-items: center;
    margin-top: var(--space-2xl);
    padding: var(--space-lg) 0;
}

.page-nav a {
    text-decoration: none;
    color: var(--primary-start);
    font-weight: 600;
}

.page-nav .hidden {
    visibility: hidden;
}

/* ==========================================
   Responsive Design
   ========================================== */
@media (max-width: 1024px) {
    .docs-sidebar {
        display: none;
    }
    
    .docs-content {
        margin-left: 0;
    }
}

@media (max-width: 768px) {
    .nav-links {
        display: none;
    }
    
    .nav-menu-toggle {
        display: block;
    }
    
    .nav-search {
        max-width: none;
    }
    
    .page-header h1 {
        font-size: 1.75rem;
    }
    
    .step-box {
        padding: var(--space-md);
    }
}

@media (max-width: 480px) {
    .docs-nav {
        padding: 0 var(--space-md);
    }
    
    .docs-content {
        padding: var(--space-md);
    }
    
    .page-nav {
        flex-direction: column;
        gap: var(--space-md);
    }
}