/* ============================================================================
   PALETTE & THEME TOKENS
   - Variabili a livello :root per il tema "light" (default).
   - Override in body[data-theme="dark"] per il tema scuro.
   ========================================================================== */
:root {
    --bg: #ffffff;
    --text: #111827;
    --muted: #4b5563;
    --border: #d1d5db;
    --panel: #f3f4f6;
    --accent: #6366f1;
}

body[data-theme="dark"] {
    --bg: #0f172a;
    --text: #e5e7eb;
    --muted: #cbd5e1;
    --border: #374151;
    --panel: #111827;
    --accent: #8b8df8;
}


/* ============================================================================
   GLOBAL RESET MINIMO
   - Box sizing border-box per calcoli prevedibili.
   - Altezza 100% su html/body per ancorare viewport-based layouts.
   - Tipografia di base e colori legati alle variabili tema.
   - Smooth scroll a livello documento per UX migliore sugli anchor link.
   ========================================================================== */
* {
    box-sizing: border-box;
}

html,
body {
    height: 100%;
}

html {
    scroll-behavior: smooth;
}

body {
    margin: 0;
    font-family: system-ui, -apple-system, "Segoe UI", Inter, Roboto, Arial, "Helvetica Neue", sans-serif;
    background: var(--bg);
    color: var(--text);
    line-height: 1.65;
}


/* ============================================================================
   NAVBAR LATERALE (DESKTOP)
   Ruolo: indice persistente a sinistra, sempre visibile su schermi ampi.
   Dettagli:
   - position: fixed per restare in viewport durante lo scroll del contenuto.
   - overflow-y: auto per consentire lo scorrimento in caso di molte voci.
   - layout colonna con gap ridotto per densità informativa.
   ========================================================================== */
#navbar {
    position: fixed;
    top: 0;
    left: 0;
    width: 280px;
    height: 100vh;
    padding: 16px 12px;
    background: var(--panel);
    border-right: 1px solid var(--border);
    overflow-y: auto;
    display: flex;
    flex-direction: column;
    gap: 6px;
}

/* Header del menu
   - Tipografia più marcata.
   - Separatore inferiore per distinguere visivamente le voci. */
.nav-header {
    font-weight: 700;
    font-size: 1.3rem;
    padding: 12px;
    margin-bottom: 12px;
    border-bottom: 2px solid var(--border);
}

/* Link del menu (stato base)
   - Aspetto “card/tab” con bordo e raggio morbido.
   - Il colore di sfondo è neutro; il testo usa --text (dipendente dal tema). */
.nav-link {
    display: block;
    padding: 12px 16px;
    margin: 0;
    background: #ffffff;
    color: var(--text);
    text-decoration: none;
    border: 1px solid var(--border);
    border-radius: 8px;
    transition: all 0.2s ease;
}

/* Variante dark per i link della navbar
   - Sfondo più scuro per contrasto con il pannello dark.
   - Mantiene i bordi coerenti con --border del tema. */
body[data-theme="dark"] .nav-link {
    background: #1f2937;
    color: var(--text);
    border-color: var(--border);
}

/* Stati interattivi: hover/focus-visible
   - Evidenziazione con il colore di accento e leggera animazione di scala.
   - focus-visible per accessibilità tastiera. */
.nav-link:hover,
.nav-link:focus-visible {
    background: var(--accent);
    color: #ffffff;
    outline: none;
    transform: scale(1.02);
}

/* Stato attivo (sincronizzato via JS con IntersectionObserver)
   - Forza accento e peso testo per orientamento utente. */
body[data-theme="dark"] .nav-link:hover,
.nav-link.active {
    background: var(--accent);
    color: #ffffff;
    font-weight: 600;
    border-color: var(--accent);
}

body[data-theme="dark"] .nav-link.active {
    background: var(--accent);
    color: #ffffff;
    border-color: var(--accent);
}

/* ============================================================================
   AREA CONTENUTI (MAIN)
   Obiettivo: lasciare spazio alla sidebar a sinistra e CENTRARE il contenuto
   dell’articolo in una colonna leggibile.
   ========================================================================== */
#main-doc {
    margin-left: 280px;
    padding: 32px 24px;
}

/* Wrapper centrale
   - Limita la larghezza per mantenere una misura di riga confortevole.
   - margin-inline: auto centra la colonna nello spazio disponibile. */
.main-inner {
    max-width: 980px;
    margin-inline: auto;
}

/* Sezioni del documento
   - Spaziatura verticale coerente.
   - scroll-margin-top migliora l’ancoraggio con header fissi (se aggiunti in futuro). */
.main-section {
    margin: 28px 0 46px;
    scroll-margin-top: 16px;
}

/* Titoli sezione
   - Gerarchia visiva chiara e compatta. */
.main-section>header h2 {
    margin: 0 0 12px;
    font-size: 2rem;
    line-height: 1.25;
}

/* Testo e liste all’interno delle sezioni
   - Margini compatti per densità senza sacrificare la leggibilità. */
.main-section p {
    margin: 10px 0;
    color: var(--text);
}

.main-section ul {
    margin: 10px 0 10px 20px;
}

.main-section li {
    margin: 6px 0;
}


/* ============================================================================
   CODICE (inline e blocchi)
   - Font monospace di sistema per performance e resa coerente.
   - Evidenziazione soft dello sfondo per l’inline code.
   - “Card” di codice per i blocchi <pre>.
   ========================================================================== */
code {
    font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
    background: rgba(99, 102, 241, .08);
    padding: .15rem .35rem;
    border-radius: 4px;
}

/* Blocco di codice
   - Usa le superfici del tema (panel/border).
   - overflow-x per prevenire rotture layout su righe lunghe. */
pre {
    background: var(--panel);
    border: 1px solid var(--border);
    border-radius: 8px;
    padding: 14px;
    overflow-x: auto;
    margin: 12px 0;
}

/* Rimuove lo sfondo dall’inline code dentro <pre>
   per evitare “double background”. */
pre code {
    background: transparent;
    padding: 0;
}


/* ============================================================================
   THEME TOGGLE (icona in alto a destra)
   - Posizionamento fisso per accesso rapido.
   - Z-index alto per evitare sovrapposizioni.
   ========================================================================== */
.theme-icon {
    position: fixed;
    top: 16px;
    right: 18px;
    font-size: 1.6rem;
    color: var(--text);
    cursor: pointer;
    user-select: none;
    z-index: 1000;
}


/* ============================================================================
   RESPONSIVE DESIGN (TABLET/MOBILE)
   Breakpoint: max-width 960px
   - La navbar passa da colonna fissa a barra superiore scrollabile.
   - Il main recupera il margine sinistro e riduce il padding.
   - La griglia 2 colonne per i link aumenta la densità senza perdere leggibilità.
   ========================================================================== */
@media (max-width: 960px) {

    /* Navbar diventa “contenuto di flusso” e va in cima alla pagina */
    #navbar {
        position: static;
        width: auto;
        height: auto;
        border-right: none;
        border-bottom: 1px solid var(--border);
        display: grid;
        grid-template-columns: 1fr 1fr;
        gap: 8px;
    }

    /* Header della navbar occupa tutta la riga in griglia */
    .nav-header {
        grid-column: 1 / -1;
        margin-bottom: 4px;
        border-bottom: none;
        padding-bottom: 0;
    }

    /* Margini più serrati per i link su mobile */
    .nav-link {
        margin: 2px 0;
    }

    /* Il main si riallinea senza offset di sidebar */
    #main-doc {
        margin-left: 0;
        padding: 22px 16px;
    }
}