/*
 * Design Philosophy:
 * Inspired by VitePress and Apple's Human Interface Guidelines.
 * Prioritizes clarity, readability, and a clean, modern aesthetic.
 * Utilizes CSS variables for a robust and easily maintainable theme system (Light/Dark).
 * Employs smooth transitions and subtle animations to enhance user experience without being distracting.
 * Fully responsive, ensuring a seamless experience from mobile to desktop.
 */

/* 1. Global Styles & CSS Variables =================================== */
:root {
    --font-family-base: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", sans-serif;
    --font-family-mono: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, Courier, monospace;

    /* Spacing */
    --spacing-unit: 8px;

    /* Light Theme Colors */
    --c-bg: #ffffff;
    --c-bg-soft: #f9f9f9;
    --c-bg-mute: #f1f1f1;
    --c-border: #e2e2e3;
    --c-divider: #e2e2e3;
    --c-text-1: #213547;
    --c-text-2: #3c5369;
    --c-text-3: #90a0b2;
    --c-brand: #646cff;
    --c-brand-light: #747bff;
    --c-brand-dark: #535bf2;
    --c-tip: #42b983;
    --c-tip-bg: rgba(66, 185, 131, 0.1);
    --c-tip-border: rgba(66, 185, 131, 0.2);
    --c-warning: #ffc107;
    --c-warning-bg: rgba(255, 193, 7, 0.1);
    --c-warning-border: rgba(255, 193, 7, 0.2);
    --c-danger: #f96666;
    --c-danger-bg: rgba(249, 102, 102, 0.1);
    --c-danger-border: rgba(249, 102, 102, 0.2);
    --c-code-bg: #282c34;

    /* Shadows */
    --shadow-1: 0 1px 2px rgba(0, 0, 0, 0.04), 0 1px 3px rgba(0, 0, 0, 0.1);
    --shadow-2: 0 3px 12px rgba(0, 0, 0, 0.07), 0 1px 4px rgba(0, 0, 0, 0.07);
}

html.dark {
    --c-bg: #1e1e20;
    --c-bg-soft: #28282a;
    --c-bg-mute: #343436;
    --c-border: #38383a;
    --c-divider: #424244;
    --c-text-1: rgba(255, 255, 255, 0.87);
    --c-text-2: rgba(235, 235, 235, 0.6);
    --c-text-3: rgba(235, 235, 235, 0.38);
    --c-brand: #747bff;
    --c-brand-light: #8b92ff;
    --c-brand-dark: #646cff;
    --c-tip-bg: rgba(66, 185, 131, 0.15);
    --c-tip-border: rgba(66, 185, 131, 0.3);
    --c-warning-bg: rgba(255, 193, 7, 0.15);
    --c-warning-border: rgba(255, 193, 7, 0.3);
    --c-danger-bg: rgba(249, 102, 102, 0.15);
    --c-danger-border: rgba(249, 102, 102, 0.3);
}

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

html {
    scroll-behavior: smooth;
}

body {
    font-family: var(--font-family-base);
    font-size: 16px;
    line-height: 1.7;
    font-weight: 400;
    color: var(--c-text-1);
    background-color: var(--c-bg);
    transition: background-color 0.3s ease, color 0.3s ease;
}

/* 2. Layout Structure ================================================ */
#app {
    display: flex;
    flex-direction: column;
    min-height: 100vh;
}

.container {
    width: 100%;
    margin: 0 auto;
    padding: 0 calc(var(--spacing-unit) * 3);
}

.main-content {
    display: flex;
    flex-grow: 1;
}

/* 3. Header & Navigation ============================================= */
.header {
    position: sticky;
    top: 0;
    z-index: 100;
    height: 60px;
    background-color: rgba(255, 255, 255, 0.7);
    backdrop-filter: blur(8px);
    -webkit-backdrop-filter: blur(8px);
    border-bottom: 1px solid var(--c-divider);
    transition: background-color 0.3s, border-color 0.3s;
}
html.dark .header {
    background-color: rgba(30, 30, 32, 0.7);
}
.header .container {
    display: flex;
    justify-content: space-between;
    align-items: center;
    height: 100%;
}

.logo {
    display: flex;
    align-items: center;
    font-size: 1.25rem;
    font-weight: 600;
    color: var(--c-text-1);
    text-decoration: none;
    cursor: pointer;
}
.logo svg {
    width: 28px;
    height: 28px;
    margin-right: 10px;
    color: var(--c-brand);
}

.nav-links {
    display: none;
    gap: calc(var(--spacing-unit) * 3);
}
.nav-link {
    text-decoration: none;
    color: var(--c-text-2);
    font-weight: 500;
    transition: color 0.2s ease;
}
.nav-link:hover, .nav-link.active {
    color: var(--c-brand);
}

.header-controls {
    display: flex;
    align-items: center;
    gap: calc(var(--spacing-unit) * 2);
}

.theme-toggle {
    background: none;
    border: none;
    cursor: pointer;
    color: var(--c-text-2);
    width: 24px;
    height: 24px;
}
.theme-toggle svg {
    transition: transform 0.3s ease;
}
.theme-toggle:hover svg {
    transform: scale(1.1) rotate(15deg);
    color: var(--c-brand);
}
.theme-toggle .icon-sun { display: none; }
.theme-toggle .icon-moon { display: block; }
html.dark .theme-toggle .icon-sun { display: block; }
html.dark .theme-toggle .icon-moon { display: none; }

.mobile-menu-toggle {
    display: block;
    background: none;
    border: none;
    cursor: pointer;
    color: var(--c-text-2);
    padding: 8px;
    position: relative;
    width: 40px;
    height: 40px;
}
.mobile-menu-toggle .icon-menu,
.mobile-menu-toggle .icon-close {
    position: absolute;
    top: 50%;
    left: 50%;
    transform: translate(-50%, -50%);
    transition: opacity 0.2s ease, transform 0.2s ease;
}
.mobile-menu-toggle .icon-close {
    opacity: 0;
    transform: translate(-50%, -50%) rotate(90deg);
}
.mobile-menu-toggle.is-open .icon-menu {
    opacity: 0;
    transform: translate(-50%, -50%) rotate(-90deg);
}
.mobile-menu-toggle.is-open .icon-close {
    opacity: 1;
    transform: translate(-50%, -50%) rotate(0deg);
}


.mobile-nav-screen {
    position: fixed;
    top: 60px;
    left: 0;
    width: 100%;
    height: calc(100vh - 60px);
    background-color: var(--c-bg-soft);
    transform: translateX(-100%);
    transition: transform 0.3s ease-in-out;
    padding: calc(var(--spacing-unit) * 4);
    z-index: 99;
    overflow-y: auto;
}
.mobile-nav-screen.is-open {
    transform: translateX(0);
}
.mobile-nav-links {
    display: flex;
    flex-direction: column;
    gap: calc(var(--spacing-unit) * 2);
    border-bottom: 1px solid var(--c-divider);
    padding-bottom: calc(var(--spacing-unit) * 2);
    margin-bottom: calc(var(--spacing-unit) * 2);
}
.mobile-nav-links .nav-link {
    font-size: 1.2rem;
}

/* 4. Homepage ======================================================== */
.home-page {
    text-align: center;
    padding: calc(var(--spacing-unit) * 10) 0;
    flex-grow: 1;
}
.home-page h1 {
    font-size: 3.5rem;
    font-weight: 800;
    background: linear-gradient(120deg, var(--c-brand-dark) 0%, var(--c-brand-light) 100%);
    -webkit-background-clip: text;
    -webkit-text-fill-color: transparent;
    margin-bottom: var(--spacing-unit);
    letter-spacing: -1px;
}
.home-page .tagline {
    font-size: 1.5rem;
    color: var(--c-text-2);
    margin-bottom: calc(var(--spacing-unit) * 6);
}

.feature-grid {
    display: grid;
    grid-template-columns: repeat(1, 1fr);
    gap: calc(var(--spacing-unit) * 3);
    max-width: 1152px;
    margin: 0 auto;
}

.feature-card {
    display: block;
    text-decoration: none;
    background-color: var(--c-bg-soft);
    border: 1px solid var(--c-border);
    border-radius: 12px;
    padding: calc(var(--spacing-unit) * 4);
    text-align: left;
    transition: transform 0.2s ease, box-shadow 0.2s ease, border-color 0.2s ease;
    cursor: pointer;
}
.feature-card:hover {
    transform: translateY(-5px);
    box-shadow: var(--shadow-2);
    border-color: var(--c-brand);
}
.feature-card h2 {
    font-size: 1.25rem;
    color: var(--c-text-1);
    margin-bottom: var(--spacing-unit);
}
.feature-card p {
    color: var(--c-text-2);
    line-height: 1.6;
}

/* 5. Documentation Page ============================================== */
.doc-page {
    flex-grow: 1;
}

.sidebar {
    width: 280px;
    flex-shrink: 0;
    border-right: 1px solid var(--c-divider);
    padding: calc(var(--spacing-unit) * 4) 0;
    padding-right: calc(var(--spacing-unit) * 3);
    height: calc(100vh - 60px);
    position: sticky;
    top: 60px;
    overflow-y: auto;
}

.sidebar-nav-group-title {
    font-size: 0.8rem;
    font-weight: 700;
    text-transform: uppercase;
    color: var(--c-text-3);
    margin-bottom: var(--spacing-unit);
    padding: 0 calc(var(--spacing-unit) * 3);
}

.sidebar-nav-links {
    list-style: none;
}
.sidebar-nav-link a {
    display: block;
    padding: calc(var(--spacing-unit) * 1.25) calc(var(--spacing-unit) * 3);
    text-decoration: none;
    color: var(--c-text-2);
    font-weight: 500;
    border-radius: 6px;
    transition: background-color 0.2s, color 0.2s;
}
.sidebar-nav-link a:hover {
    background-color: var(--c-bg-mute);
    color: var(--c-text-1);
}
.sidebar-nav-link a.active {
    background-color: var(--c-brand-light);
    color: #fff;
    font-weight: 600;
}
html.dark .sidebar-nav-link a.active {
     background-color: var(--c-brand);
}

.doc-content {
    padding: calc(var(--spacing-unit) * 6) calc(var(--spacing-unit) * 8);
    max-width: 800px;
    margin: 0 auto;
    flex-grow: 1;
}
.doc-content > *:first-child {
    margin-top: 0;
}

/* 6. Content Elements ================================================ */
h1, h2, h3, h4, h5, h6 {
    font-weight: 600;
    color: var(--c-text-1);
    margin-top: 2.25em;
    margin-bottom: 1em;
}
h1 { font-size: 2.2rem; }
h2 { font-size: 1.65rem; border-bottom: 1px solid var(--c-divider); padding-bottom: .3em; }
h3 { font-size: 1.35rem; }
h4 { font-size: 1.15rem; }

p {
    margin-bottom: 1.25em;
}

a {
    color: var(--c-brand);
    text-decoration: none;
    font-weight: 500;
    transition: color 0.2s;
}
a:hover {
    color: var(--c-brand-light);
}

strong {
    font-weight: 600;
}

img {
    max-width: 100%;
    border-radius: 8px;
    border: 1px solid var(--c-divider);
    margin: 1.5em 0;
}

/* Table */
.table-container {
    overflow-x: auto;
    margin: 1.5em 0;
}
table {
    width: 100%;
    border-collapse: collapse;
    text-align: left;
    border: 1px solid var(--c-divider);
    border-radius: 8px;
    overflow: hidden;
}
th, td {
    padding: 12px 16px;
    border-bottom: 1px solid var(--c-divider);
}
th {
    background-color: var(--c-bg-soft);
    font-weight: 600;
    color: var(--c-text-1);
}
tr:last-child td {
    border-bottom: none;
}
tr:nth-child(even) {
    background-color: var(--c-bg-soft);
}

/* Buttons */
.button {
    display: inline-block;
    border: 1px solid transparent;
    text-align: center;
    font-weight: 600;
    white-space: nowrap;
    transition: color 0.25s, border-color 0.25s, background-color 0.25s;
    cursor: pointer;
    border-radius: 20px;
    padding: 0 20px;
    line-height: 38px;
    font-size: 14px;
    text-decoration: none;
}
.button.brand {
    border-color: var(--c-brand);
    color: #fff;
    background-color: var(--c-brand);
}
.button.brand:hover {
    border-color: var(--c-brand-light);
    background-color: var(--c-brand-light);
}
.button.alt {
    border-color: var(--c-brand);
    color: var(--c-brand);
    background-color: transparent;
}
.button.alt:hover {
    border-color: var(--c-brand-light);
    color: var(--c-brand-light);
    background-color: var(--c-bg-soft);
}

/* Code Blocks */
pre, code {
    font-family: var(--font-family-mono);
}
code {
    background-color: var(--c-bg-mute);
    padding: 0.2em 0.4em;
    border-radius: 4px;
    font-size: 0.9em;
    color: var(--c-text-2);
}
pre {
    background-color: var(--c-code-bg);
    color: #f8f8f2;
    padding: 1.25em 1.5em;
    border-radius: 8px;
    overflow-x: auto;
    margin: 1.5em 0;
    line-height: 1.4;
}
pre code {
    background-color: transparent;
    padding: 0;
    border-radius: 0;
    font-size: inherit;
    color: inherit;
}

/* Custom Blocks (Tip, Warning, Danger) */
.custom-block {
    padding: 1em 1.5em;
    border-radius: 8px;
    margin: 1.5em 0;
    border-left-width: 4px;
    border-left-style: solid;
}
.custom-block p:last-child {
    margin-bottom: 0;
}
.custom-block .custom-block-title {
    font-weight: 600;
    margin-bottom: 0.5em;
}
.custom-block.tip {
    background-color: var(--c-tip-bg);
    border-left-color: var(--c-tip);
    border: 1px solid var(--c-tip-border);
}
.custom-block.tip .custom-block-title { color: var(--c-tip); }

.custom-block.warning {
    background-color: var(--c-warning-bg);
    border-left-color: var(--c-warning);
    border: 1px solid var(--c-warning-border);
}
.custom-block.warning .custom-block-title { color: var(--c-warning); }

.custom-block.danger {
    background-color: var(--c-danger-bg);
    border-left-color: var(--c-danger);
    border: 1px solid var(--c-danger-border);
}
.custom-block.danger .custom-block-title { color: var(--c-danger); }


/* 7. Footer ======================================================== */
.footer {
    padding: calc(var(--spacing-unit) * 4) 0;
    text-align: center;
    border-top: 1px solid var(--c-divider);
    color: var(--c-text-3);
    font-size: 0.9rem;
}


/* 8. Animations & Transitions ======================================= */
.fade-in-up {
    opacity: 0;
    transform: translateY(20px);
    transition: opacity 0.5s ease-out, transform 0.5s ease-out;
}
.fade-in-up.is-visible {
    opacity: 1;
    transform: translateY(0);
}


/* 9. Responsive Design =============================================== */
@media (min-width: 768px) {
    .container {
        padding: 0 calc(var(--spacing-unit) * 6);
    }
    .nav-links {
        display: flex;
    }
    .mobile-menu-toggle {
        display: none;
    }
    .feature-grid {
        grid-template-columns: repeat(auto-fit, minmax(320px, 1fr));
    }
    .home-page h1 {
        font-size: 4rem;
    }
    .home-page .tagline {
        font-size: 1.8rem;
    }
    
}
@media (max-width: 768px) {
    .doc-content {
        padding: calc(var(--spacing-unit) * 6) calc(var(--spacing-unit) * 1) !important;
    }
}

@media (max-width: 959px) {
    .sidebar {
        display: none;
    }
    .doc-page.has-sidebar .doc-content {
        max-width: 100%;
        margin: 0;
    }
}

@media (min-width: 960px) {
    .doc-page.has-sidebar .doc-content {
        margin: 0;
        max-width: calc(100% - 280px);
    }
}

@media (min-width: 1280px) {
    .container {
        max-width: 1152px;
    }
    .doc-content {
        padding: calc(var(--spacing-unit) * 6) calc(var(--spacing-unit) * 10);
    }
}