:root {
    /* ===== USER-CONFIGURABLE THEME VARIABLES ===== */
    /* The Composer's Workshop — burnt orange on warm dark */
    --user-surface-bg-rgb: 28, 22, 14;
    --user-accent-primary-rgb: 212, 98, 43;
    --user-accent-secondary-rgb: 201, 164, 106;
    --user-accent-tertiary-rgb: 166, 124, 82;
    --user-bg-dark: #0F0C08;

    /* ===== FONTS ===== */
    --font-display: 'Instrument Serif', Georgia, serif;
    --font-body: 'Newsreader', Georgia, serif;
    --font-mono: 'JetBrains Mono', 'Fira Code', monospace;
    --font-ui: 'Newsreader', Georgia, serif;

    /* Type scale */
    --font-size-hero: clamp(2.5rem, 5vw, 4rem);
    --font-size-h1: clamp(1.8rem, 3vw, 2.5rem);
    --font-size-h2: clamp(1.4rem, 2.5vw, 1.8rem);
    --font-size-h3: clamp(1.1rem, 2vw, 1.3rem);
    --font-size-body: 1.05rem;
    --font-size-small: 0.9rem;
    --font-size-code: 0.88rem;
    --font-size-ui: 0.85rem;
    /* Legacy sizes (kept for component compatibility) */
    --font-size-xs: 16px;
    --font-size-sm: 24px;
    --font-size-base: 32px;
    --font-size-md: 48px;
    --font-size-lg: 64px;

    /* ===== SPACING ===== */
    --spacing-xs: 0.25rem;
    --spacing-sm: 0.5rem;
    --spacing-md: 1rem;
    --spacing-lg: 1.5rem;
    --spacing-xl: 2.5rem;
    --spacing-2xl: 4rem;
    --spacing-3xl: 6rem;
    --content-max-width: 900px;
    --page-max-width: 1200px;
    --wide-max-width: 1400px;

    /* ===== DERIVED/SYSTEM VARIABLES ===== */
    /* Surface colors and opacity */
    --surface-bg-rgb: var(--user-surface-bg-rgb);
    --surface-opacity-light: 0.12;
    --surface-opacity-medium: 0.35;
    --surface-opacity-strong: 0.85;
    --surface-blur: 12px;

    /* Text colors — warm parchment tones */
    --text-primary-rgb: 240, 230, 216;
    --text-primary: rgba(var(--text-primary-rgb), 0.92);
    --text-secondary: rgba(240, 230, 216, 0.70);
    --text-dimmed: rgba(180, 165, 145, 0.60);
    --text-bright: rgba(255, 248, 235, 0.97);

    /* Accent/highlight colors */
    --accent-primary-rgb: var(--user-accent-primary-rgb);
    --accent-secondary-rgb: var(--user-accent-secondary-rgb);
    --accent-tertiary-rgb: var(--user-accent-tertiary-rgb);
    --accent-primary: rgb(var(--accent-primary-rgb));
    --accent-secondary: rgb(var(--accent-secondary-rgb));
    --accent-tertiary: rgb(var(--accent-tertiary-rgb));
    --highlight-opacity: 0.15;
    --highlight-hover-opacity: 0.3;

    /* Borders */
    --border-color: rgba(166, 124, 82, 0.25);
    --border-color-strong: rgba(166, 124, 82, 0.45);

    /* Scrollbar colors */
    --scrollbar-track-bg: rgba(var(--surface-bg-rgb), 0.3);
    --scrollbar-thumb-bg: rgba(var(--accent-primary-rgb), 0.3);
    --scrollbar-thumb-hover-bg: rgba(var(--accent-primary-rgb), 0.5);
    --scrollbar-width: 10px;

    /* Status/semantic colors — warm shifted */
    --color-success: #5CB85C;
    --color-success-dim: #4a9a4a;
    --color-error: #D9534F;
    --color-error-dim: #b94440;
    --color-warning: #E8A838;
    --color-warning-dim: #cc9330;
    --color-info: rgb(var(--user-accent-primary-rgb));

    /* Footer */
    --footer-bg: #1A1510;

    /* Legacy/page-specific */
    --bg-dark: var(--user-bg-dark);

    /* ===== CODE BLOCK COLORS ===== */
    --code-bg: #13100B;
    --code-border: rgba(var(--accent-primary-rgb), 0.3);
    --code-keyword: rgb(var(--accent-primary-rgb));
    --code-string: rgb(var(--accent-secondary-rgb));
    --code-function: #E8C577;
    --code-comment: #6B5D4D;
    --code-variable: rgba(240, 230, 216, 0.9);
    --code-type: #D4926B;
    --code-number: rgb(var(--accent-tertiary-rgb));
    --code-line-number: rgba(166, 124, 82, 0.35);

    /* ===== COMPONENT VARIABLES ===== */
    /* Header (shadow-header) */
    --header-background-color: rgba(15, 12, 8, 0.85);
    --header-backdrop-filter: blur(var(--surface-blur));
    --header-height: 64px;
    --header-padding: 0 1.5em;
    --header-text-color: var(--text-primary);
    --header-h1-color: var(--text-bright);
    --header-text-highlight-color: rgba(var(--accent-primary-rgb), 0.5);
    --slotted-header-h1-color: var(--text-bright);
    --slotted-header-text-color: var(--text-secondary);
    --slotted-header-text-highlight-color: rgba(var(--accent-primary-rgb), var(--highlight-hover-opacity));

    /* Nav (shadow-nav) */
    --nav-background-color: rgba(15, 12, 8, 0.9);
    --nav-backdrop-filter: blur(var(--surface-blur));
    --nav-width: 260px;
    --nav-text-color: var(--text-primary);
    --nav-transition: all 250ms ease;
    --nav-ul-margin: 0;
    --nav-ul-padding: 0;
    --nav-list-style-type: none;
    --nav-li-cursor: pointer;
    --nav-li-padding: 10px 12px 10px 16px;
    --nav-li-font-size: 15px;
    --nav-li-highlight-color: rgba(var(--accent-primary-rgb), var(--highlight-opacity));
    --nav-sublistitem-padding-left: 24px;
    --slotted-nav-transition: all 200ms ease;
    --slotted-nav-li-cursor: pointer;
    --slotted-nav-li-padding: 10px 12px 10px 16px;
    --slotted-nav-li-border: 1px solid transparent;
    --slotted-nav-li-highlight-color: rgba(var(--accent-primary-rgb), var(--highlight-opacity));

    /* Window (shadow-window) */
    --background-color: rgba(var(--surface-bg-rgb), var(--surface-opacity-light));
    --window-text-color: var(--text-bright);
    --window-text-unfocused: var(--text-dimmed);
    --window-nav-bg-unfocused: rgba(var(--surface-bg-rgb), 0.05);
    --window-nav-bg-focused: rgba(var(--surface-bg-rgb), var(--surface-opacity-medium));
    --window-close-button-text-color: var(--text-bright);
    --window-close-button-bg-color: rgba(217, 83, 79, 0.8);
    --window-close-button-hover-text-color: var(--text-bright);
    --window-close-button-hover-bg-color: rgba(217, 83, 79, 1);

    /* ===== ANIMATION ===== */
    --ease-out-smooth: cubic-bezier(0.25, 0.46, 0.45, 0.94);
    --transition-fast: 150ms;
    --transition-base: 200ms;
    --transition-slow: 400ms;
}

/* ===== GLOBAL RESET ===== */
html {
    scroll-behavior: smooth;
}

* {
    margin: 0;
    padding: 0;
    box-sizing: border-box;
    scrollbar-width: thin;
    scrollbar-color: var(--scrollbar-thumb-bg) var(--scrollbar-track-bg);
}

/* Webkit scrollbar */
*::-webkit-scrollbar { width: var(--scrollbar-width); height: var(--scrollbar-width); }
*::-webkit-scrollbar-track { background: var(--scrollbar-track-bg); }
*::-webkit-scrollbar-thumb { background: var(--scrollbar-thumb-bg); border-radius: 5px; border: 2px solid var(--scrollbar-track-bg); }
*::-webkit-scrollbar-thumb:hover { background: var(--scrollbar-thumb-hover-bg); }

/* ===== GLOBAL FORM ELEMENTS ===== */
button,
input[type="submit"],
input[type="button"],
input[type="reset"],
select {
    font-family: inherit;
}

/* ===== BODY & BACKGROUND ===== */
body {
    min-height: 100dvh;
    background: var(--bg-dark);
    position: relative;
    display: flex;
    flex-direction: column;
    font-family: var(--font-body);
    font-size: var(--font-size-body);
    line-height: 1.7;
    color: var(--text-primary);
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
}

/* Grain texture overlay */
body::before {
    content: '';
    position: fixed;
    top: 0;
    left: 0;
    width: 100%;
    height: 100%;
    pointer-events: none;
    z-index: 999;
    opacity: 0.035;
    background-image: url("data:image/svg+xml,%3Csvg viewBox='0 0 256 256' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='noise'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.9' numOctaves='4' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23noise)'/%3E%3C/svg%3E");
    background-repeat: repeat;
    background-size: 256px 256px;
}

::selection {
    background: rgba(var(--accent-primary-rgb), 0.35);
    color: var(--text-bright);
}

/* ===== FOCUS STYLES ===== */
/* Keyboard-accessible focus ring */
:focus-visible {
    outline: 2px solid rgba(var(--accent-primary-rgb), 0.6);
    outline-offset: 2px;
    border-radius: 2px;
}

/* Remove outline for mouse users */
:focus:not(:focus-visible) {
    outline: none;
}

/* ===== CONTENT ENTRY ANIMATION ===== */
@keyframes fadeInUp {
    from { opacity: 0; transform: translateY(12px); }
    to   { opacity: 1; transform: translateY(0); }
}

/* ===== TYPOGRAPHY ===== */
h1, h2, h3 {
    font-family: var(--font-display);
    font-weight: 400;
    line-height: 1.2;
    color: var(--text-bright);
}

h1 { font-size: var(--font-size-h1); margin-bottom: var(--spacing-md); }
h2 { font-size: var(--font-size-h2); margin-bottom: var(--spacing-md); }
h3 { font-size: var(--font-size-h3); margin-bottom: var(--spacing-sm); }

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

code {
    font-family: var(--font-mono);
    font-size: var(--font-size-code);
    background: var(--code-bg);
    padding: 0.15em 0.45em;
    border-radius: 3px;
    border: 1px solid var(--border-color);
    color: var(--accent-secondary);
    word-break: break-word;
}

pre {
    font-family: var(--font-mono);
    font-size: var(--font-size-code);
    background: var(--code-bg);
    padding: var(--spacing-lg);
    border-radius: 2px 6px 6px 2px;
    border-left: 3px solid rgba(var(--accent-primary-rgb), 0.5);
    overflow-x: auto;
    line-height: 1.6;
    margin-bottom: var(--spacing-lg);
}

pre code {
    background: none;
    padding: 0;
    border: none;
    color: var(--code-variable);
}

/* ===== LINKS ===== */
a {
    color: var(--accent-primary);
    text-decoration: none;
    transition: color var(--transition-base) ease;
}

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

/* ===== WORDMARK ===== */
.site-wordmark {
    font-family: var(--font-display);
    color: var(--text-bright);
    letter-spacing: 0.02em;
    transition: color var(--transition-base) ease;
}

.site-wordmark:hover {
    color: var(--accent-primary);
    text-decoration: none;
}

/* ===== MAIN CONTENT ===== */
#main {
    flex: 1;
    padding: var(--spacing-xl);
    padding-top: calc(var(--header-height) + var(--spacing-xl));
    max-width: var(--page-max-width);
    margin: 0 auto;
    width: 100%;
    animation: fadeInUp 0.4s var(--ease-out-smooth) both;
}

/* ===== STAFF LINE DIVIDER ===== */
/* Five parallel lines — the musical stave as a section separator */
.staff-divider {
    display: flex;
    flex-direction: column;
    gap: 4px;
    padding: var(--spacing-xl) 0;
    max-width: 200px;
    margin: 0 auto;
    opacity: 0.3;
}

.staff-divider span {
    display: block;
    height: 1px;
    background: linear-gradient(90deg, transparent, var(--accent-tertiary), transparent);
}

hr {
    border: none;
    display: flex;
    flex-direction: column;
    gap: 3px;
    padding: var(--spacing-lg) 0;
    max-width: 120px;
    margin: 0 auto;
}

hr::before,
hr::after {
    content: '';
    display: block;
    height: 1px;
    background: linear-gradient(90deg, transparent, var(--accent-tertiary), transparent);
}

hr::before {
    margin-bottom: 3px;
}

/* ===== NAVIGATION STYLES ===== */
/* Styles for nav items in the shadow-nav */
shadow-nav a {
    color: var(--text-secondary);
    text-decoration: none;
    display: flex;
    align-items: center;
    gap: 10px;
    font-family: var(--font-ui);
    font-size: 0.9rem;
    transition: color var(--transition-base) ease;
}

shadow-nav a:hover {
    color: var(--accent-primary);
    text-decoration: none;
}

shadow-nav a .material-symbols-outlined {
    font-size: 20px;
    opacity: 0.7;
}

shadow-nav .nav-section-title {
    font-family: var(--font-display);
    font-size: 0.8rem;
    color: var(--text-dimmed);
    text-transform: uppercase;
    letter-spacing: 0.1em;
    padding: var(--spacing-md) 16px var(--spacing-xs) 16px;
    pointer-events: none;
}

shadow-nav .nav-active a {
    color: var(--accent-primary);
}

shadow-nav .nav-active a .material-symbols-outlined {
    opacity: 1;
}

/* ===== HEADER NAV LINKS ===== */
.header-nav {
    display: flex;
    align-items: center;
    gap: 2rem;
    list-style: none;
}

.header-nav a {
    color: var(--text-secondary);
    font-family: var(--font-ui);
    font-size: 0.9rem;
    text-decoration: none;
    padding: 0.25rem 0;
    border-bottom: 2px solid transparent;
    transition: color var(--transition-base) ease, border-color var(--transition-slow) ease;
    letter-spacing: 0.01em;
}

.header-nav a:hover {
    color: var(--text-bright);
    text-decoration: none;
    border-bottom-color: rgba(var(--accent-primary-rgb), 0.4);
}

.header-nav a.active {
    color: var(--accent-primary);
    border-bottom-color: var(--accent-primary);
}

.header-nav a.active:hover {
    color: var(--accent-secondary);
}

/* ===== FOOTER ===== */
.site-footer {
    background: var(--footer-bg);
    padding: var(--spacing-2xl) var(--spacing-xl);
    margin-top: auto;
    border-top: 1px solid var(--border-color);
}

.footer-container {
    display: flex;
    gap: 4em;
    max-width: var(--page-max-width);
    margin: 0 auto;
    flex-wrap: wrap;
}

.footer-section h4 {
    font-family: var(--font-display);
    font-weight: 400;
    margin-bottom: 0.75em;
    color: var(--text-bright);
    font-size: 1.1rem;
}

.footer-section p,
.footer-section a {
    font-size: var(--font-size-small);
}

.footer-section p {
    color: var(--text-secondary);
    line-height: 1.6;
}

.footer-section em {
    color: var(--accent-secondary);
}

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

.footer-links li {
    margin-bottom: 0.5em;
}

.footer-links a {
    color: var(--text-secondary);
    transition: color var(--transition-base) ease;
    display: inline-flex;
    align-items: center;
    gap: 0.3em;
}

.footer-links a::before {
    content: '\2669';
    font-size: 0.7em;
    color: var(--accent-tertiary);
    opacity: 0;
    transform: translateX(-4px);
    transition: opacity var(--transition-base) ease, transform var(--transition-base) ease;
}

.footer-links a:hover {
    color: var(--accent-primary);
    text-decoration: none;
}

.footer-links a:hover::before {
    opacity: 0.6;
    transform: translateX(0);
}

.footer-bottom {
    text-align: center;
    margin-top: var(--spacing-xl);
    padding-top: var(--spacing-lg);
    border-top: 1px solid var(--border-color);
    color: var(--text-dimmed);
    font-size: var(--font-size-small);
}

.footer-bottom a {
    color: var(--text-dimmed);
    border-bottom: 1px solid rgba(var(--accent-tertiary-rgb), 0.2);
    transition: color var(--transition-base) ease, border-color var(--transition-base) ease;
}

.footer-bottom a:hover {
    color: var(--accent-primary);
    border-bottom-color: rgba(var(--accent-primary-rgb), 0.4);
    text-decoration: none;
}

/* ===== SHARED DOC STYLES ===== */
/* Used across Zero, Shadow, and Examples modules */

/* Page header */
.doc-header {
    margin-bottom: var(--spacing-2xl);
    padding-bottom: var(--spacing-lg);
    border-bottom: 1px solid var(--border-color);
}

.doc-header h1 {
    font-family: var(--font-display);
    font-size: var(--font-size-h1);
    margin-bottom: var(--spacing-sm);
}

.doc-header .doc-lead {
    font-size: 1.1rem;
    color: var(--text-secondary);
    font-style: italic;
    max-width: var(--content-max-width);
}

/* Documentation content container */
.doc-content {
    max-width: var(--content-max-width);
}

.doc-content h2 {
    font-family: var(--font-display);
    margin-top: var(--spacing-2xl);
    padding-top: var(--spacing-lg);
    border-top: 1px solid var(--border-color);
}

.doc-content h2:first-of-type {
    margin-top: var(--spacing-xl);
    padding-top: 0;
    border-top: none;
}

.doc-content h3 {
    margin-top: var(--spacing-xl);
    color: var(--accent-secondary);
}

.doc-content p {
    line-height: 1.75;
}

.doc-content ul,
.doc-content ol {
    padding-left: 1.5rem;
    margin-bottom: var(--spacing-md);
}

.doc-content li {
    margin-bottom: var(--spacing-xs);
    line-height: 1.6;
}

/* Doc tables */
.doc-table {
    width: 100%;
    border-collapse: collapse;
    margin-bottom: var(--spacing-lg);
    font-size: var(--font-size-small);
}

.doc-table th {
    text-align: left;
    padding: 0.6rem 1rem;
    background: rgba(var(--surface-bg-rgb), 0.4);
    border-bottom: 2px solid var(--border-color);
    color: var(--accent-secondary);
    font-family: var(--font-display);
    font-weight: 400;
}

.doc-table td {
    padding: 0.5rem 1rem;
    border-bottom: 1px solid var(--border-color);
    vertical-align: top;
}

.doc-table tbody tr {
    transition: background var(--transition-fast) ease;
}

.doc-table tbody tr:hover {
    background: rgba(var(--accent-primary-rgb), 0.03);
}

.doc-table code {
    font-size: 0.82rem;
}

/* Doc cards grid */
.doc-cards {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
    gap: 1.25rem;
    margin: var(--spacing-xl) 0;
}

.doc-card {
    background: rgba(var(--surface-bg-rgb), 0.3);
    border: 1px solid var(--border-color);
    border-radius: 2px 6px 6px 2px;
    padding: 1.25rem;
    transition: border-color var(--transition-base) ease, transform var(--transition-base) ease, box-shadow var(--transition-slow) ease;
    text-decoration: none;
    display: block;
    color: inherit;
    position: relative;
}

.doc-card::before {
    content: '';
    position: absolute;
    top: 0;
    left: 0;
    width: 2px;
    height: 100%;
    background: linear-gradient(180deg, transparent, var(--accent-primary), transparent);
    opacity: 0;
    transition: opacity var(--transition-base) ease;
    border-radius: 2px 0 0 2px;
}

.doc-card:hover {
    border-color: rgba(var(--accent-primary-rgb), 0.35);
    transform: translateY(-2px);
    box-shadow: 0 4px 20px rgba(0, 0, 0, 0.15), 0 0 16px rgba(var(--accent-primary-rgb), 0.04);
    text-decoration: none;
    color: inherit;
}

.doc-card:hover::before {
    opacity: 1;
}

.doc-card h3 {
    font-family: var(--font-display);
    font-size: 1.1rem;
    color: var(--text-bright);
    margin-bottom: var(--spacing-xs);
    margin-top: 0;
    display: flex;
    align-items: center;
    gap: 0.5rem;
}

.doc-card h3 .material-symbols-outlined {
    font-size: 20px;
    color: var(--accent-primary);
    transition: transform var(--transition-base) ease;
}

.doc-card:hover h3 .material-symbols-outlined {
    transform: scale(1.1);
}

.doc-card p {
    font-size: var(--font-size-small);
    color: var(--text-secondary);
    line-height: 1.5;
    margin: 0;
}

/* File tree display */
.file-tree {
    background: var(--code-bg);
    border-radius: 2px 6px 6px 2px;
    border-left: 3px solid rgba(var(--accent-secondary-rgb), 0.4);
    padding: var(--spacing-lg);
    margin-bottom: var(--spacing-lg);
    font-family: var(--font-mono);
    font-size: var(--font-size-code);
    line-height: 1.7;
    color: var(--text-secondary);
    overflow-x: auto;
}

.file-tree span {
    display: block;
}

.file-tree .dir {
    color: var(--accent-secondary);
}

.file-tree .file {
    color: var(--text-primary);
}

.file-tree .comment {
    color: var(--code-comment);
    font-size: 0.82rem;
}

/* File tree indentation levels */
.file-tree .indent-1 { padding-left: 1.5em; }
.file-tree .indent-2 { padding-left: 3em; }
.file-tree .indent-3 { padding-left: 4.5em; }
.file-tree .indent-4 { padding-left: 6em; }
.file-tree .indent-5 { padding-left: 7.5em; }

/* Flow diagrams */
.flow-diagram {
    display: flex;
    align-items: center;
    gap: 0.5rem;
    flex-wrap: wrap;
    margin: var(--spacing-lg) 0;
    justify-content: center;
}

.flow-box {
    background: rgba(var(--surface-bg-rgb), 0.5);
    border: 1px solid var(--border-color);
    border-radius: 4px;
    padding: 0.5rem 1rem;
    font-family: var(--font-mono);
    font-size: var(--font-size-small);
    color: var(--text-primary);
    text-align: center;
    white-space: nowrap;
    transition: border-color var(--transition-base) ease;
}

.flow-box.highlight {
    border-color: rgba(var(--accent-primary-rgb), 0.5);
    color: var(--accent-primary);
    background: rgba(var(--accent-primary-rgb), 0.06);
}

.flow-arrow {
    color: var(--accent-tertiary);
    font-size: 1.2rem;
    opacity: 0.7;
}

/* ===== STAVE.DEV UTILITY CLASSES ===== */
.font-display { font-family: var(--font-display); }
.font-body { font-family: var(--font-body); }
.font-mono { font-family: var(--font-mono); }
.text-accent { color: var(--accent-primary); }
.text-secondary-accent { color: var(--accent-secondary); }
.text-dimmed { color: var(--text-dimmed); }

/* ===== RESPONSIVE ===== */
@media (max-width: 768px) {
    #main {
        padding: var(--spacing-lg);
        padding-top: calc(var(--header-height) + var(--spacing-lg));
    }

    .header-nav {
        display: none;
    }

    .footer-container {
        gap: 2em;
    }

    .doc-cards {
        grid-template-columns: 1fr;
    }

    .doc-table {
        display: block;
        overflow-x: auto;
    }

    .flow-diagram {
        flex-direction: column;
    }

    .flow-arrow {
        transform: rotate(90deg);
    }
}

/* ===== REDUCED MOTION ===== */
@media (prefers-reduced-motion: reduce) {
    *, *::before, *::after {
        animation-duration: 0.01ms !important;
        animation-iteration-count: 1 !important;
        transition-duration: 0.01ms !important;
        scroll-behavior: auto !important;
    }
}