/*
 * ==========================================================
 * PROGETTO:    Kerno Framework
 * FILE:        menu.css
 * Path:        public/css/menu.css
 * ==========================================================
 * DESCRIZIONE GENERALE:
 * Gestisce menu principale, dropdown, sottomenu, separatori e icone account.
 *
 * FUNZIONE DEL FILE:
 * Questo foglio di stile raccoglie regole CSS specifiche per: menu di navigazione.
 * Le regole definiscono solo la presentazione grafica degli elementi HTML e
 * non introducono logica applicativa. Eventuali comportamenti dinamici sono
 * gestiti dai file JavaScript o dal markup prodotto dalle view PHP.
 *
 * NOTE OPERATIVE:
 * - mantenere i selettori coerenti con il markup generato dalle view;
 * - modificare colori, spaziature e transizioni solo verificando le pagine
 *   che riutilizzano gli stessi componenti;
 * - evitare rinominazioni dei selettori senza aggiornare anche HTML e JS.
 * ==========================================================
 */

/* ==========================================================
 * SEZIONE: navigazione principale e menu a tendina
 * ========================================================== */

/*
 * Sistema di Navigazione
 *
 * Implementa una struttura flessibile e reattiva per i menu a tendina,
 * utilizzando transizioni e gradienti del tema per migliorare la UX.
 */

/* Navigazione Principale - Lista orizzontale */
.menu-main {
    display: flex;
    list-style: none;
    margin: 0;
    padding: 0;
}

/* Elemento di lista: funge da base relativa per il posizionamento dei sottomenu */
.menu-main li {
    position: relative;
}

/* Link del menu principale: definisce l'area cliccabile e l'altezza della riga */
.menu-main a {
    display: block;
    padding: 0 8px;
    line-height: 48px;
    color: var(--color-on-primary);
    text-decoration: none;
    white-space: nowrap;
    height: 55px;
}

/* Effetto al passaggio del mouse con gradiente del tema (vedi theme.css) */
.menu-main a:hover {
    color: var(--color-on-dark);
    background: var(--color-primary);
    background: linear-gradient(to bottom, var(--color-primary), var(--color-primary-dark));
}

/* Forza il cursore a freccia standard sulle voci non cliccabili */
.menu-main a.noclick {
    cursor: context-menu !important;
}

/* Struttura base per i sottomenu a discesa (Dropdown) */
.dropdown {
    position: absolute;
    top: 100%;
    left: 0;
    background: var(--color-on-primary);
    font-size: 18px;
    box-shadow: 0 4px 12px rgba(0,0,0,0.2);
    list-style: none;
    padding: 0;
    margin: 0;
    visibility: hidden;
    opacity: 0;
    z-index: 6;
}

/* Logica di visualizzazione: mostra il dropdown quando si sorvola il genitore */
.has-dropdown:hover > .dropdown {
    visibility: visible;
    opacity: 1;
}

/* Gestione dei sottomenu di 3° livello: apertura laterale a destra */
.dropdown .dropdown {
    top: 0;
    left: 100%;
}

/* Eccezione per l'ultima voce del menu principale (tipicamente l'icona
 * account, sempre allineata al bordo destro dello schermo): un suo
 * sottomenu di 3 livello aperto "a destra" (regola sopra) uscirebbe
 * dalla finestra sotto una certa larghezza, e il browser lo
 * ripiegherebbe sopra il proprio genitore invece di scorrere
 * lateralmente. Sotto la soglia si apre "a sinistra" (right: 100%
 * invece di left: 100%), verso l'area libera dello schermo; sopra la
 * soglia resta "a destra" come ogni altro sottomenu di 3 livello,
 * perche' li' lo spazio a destra c'e' davvero. Soglia scelta a vista
 * (1750px, verificata sul layout reale del menu), non calcolata dallo
 * spazio reale disponibile: un puro CSS non puo' sapere quanto spazio
 * resta a destra in un punto preciso dello schermo, solo la larghezza
 * della finestra nel suo complesso. */
@media (max-width: 1750px) {
    .menu-main > li:last-child .dropdown .dropdown {
        left: auto;
        right: 100%;
    }
}

/* Separatore visivo all'interno dei sottomenu per dividere le categorie */
.dropdown .menu-divider {
    height: 1px;
    background-color: var(--color-menu-divider);
    list-style: none;
}

/* Impedisce il cambio di colore del separatore durante il sorvolo del mouse */
.dropdown .menu-divider:hover {
    background-color: var(--color-menu-divider) !important;
}

/* Design dei singoli link all'interno dei sottomenu dropdown */
.dropdown a {
    color: var(--color-on-dark);
    height: 38px;
    line-height: 33px;
    padding: 0 20px;
    border-bottom: 1px solid var(--color-bg-soft);
}

/* Hover nei sottomenu: stesso gradiente di base dei pulsanti (vedi .btn in form.css), meno marcato del gradiente del menu principale */
.dropdown a:hover {
    color: var(--color-on-primary);
    background: linear-gradient(to bottom, var(--color-primary-light), var(--color-primary-mid));
}

/* Indicatori grafici per la navigazione nidificata */
.arrow-down { 
    font-size: 0.5em; 
    margin-left: 7px;
}

.arrow-right { 
    font-size: 0.6em; 
    margin-left: 7px;
}

/* Stile specifico per le icone degli account nei menu e nelle liste */
.icon.account {
    vertical-align: middle;
    font-size: 28px;
}

/* Testo letto dai lettori di schermo ma non mostrato: nel menu dà il nome alle
 * voci che nella barra sono solo un'icona (account, lingua). Nell'hamburger
 * (vedi sotto) diventa visibile. */
.sr-only {
    position: absolute;
    width: 1px;
    height: 1px;
    margin: -1px;
    padding: 0;
    overflow: hidden;
    clip: rect(0, 0, 0, 0);
    white-space: nowrap;
    border: 0;
}

/* ==========================================================
 * SEZIONE: menu a "hamburger" su schermo stretto
 * ========================================================== */

/* Pulsante dell'hamburger (layouts/header.php, js/nav-toggle.js): nascosto
 * sopra i 640px, dove la barra del menu sta tutta nell'intestazione. */
.nav-toggle {
    display: none;
}

/*
 * Sotto i 640px la barra non ci sta (soglia fissa, scelta sulle voci in
 * italiano con un margine per le altre lingue e per i ruoli con piu' voci):
 * il menu si nasconde e si apre da .nav-toggle come un pannello sotto
 * l'intestazione, con le voci una sotto l'altra e i sottomenu a fisarmonica
 * (classe is-open messa da nav-toggle.js, al posto dell'hover). Il pannello
 * riprende l'aspetto dei sottomenu (.dropdown a). Gli id nei selettori del
 * pulsante servono a battere le regole generali dei pulsanti (buttons.css).
 */
@media (max-width: 640px) {
    #header .nav-toggle {
        display: flex;
        align-items: center;
        justify-content: center;
        width: 44px;
        height: 44px;
        padding: 0;
        border: 0;
        border-radius: var(--radius-small);
        background: none;
        box-shadow: none;
        color: var(--color-on-primary);
        transform: none;
    }

    #header .nav-toggle:hover {
        background: rgba(255, 255, 255, 0.18);
        box-shadow: none;
        transform: none;
    }

    #header .nav-toggle:focus-visible {
        box-shadow: none;
        outline: 2px solid var(--color-on-primary);
        outline-offset: -3px;
    }

    /* Le tre lineette: la centrale e' l'elemento, le altre due i suoi
     * pseudo-elementi; aperto il menu diventano una croce. */
    .nav-toggle-bars,
    .nav-toggle-bars::before,
    .nav-toggle-bars::after {
        display: block;
        width: 22px;
        height: 2px;
        border-radius: 1px;
        background: currentColor;
        transition: transform 0.15s ease, background-color 0.15s ease;
    }

    .nav-toggle-bars {
        position: relative;
    }

    .nav-toggle-bars::before,
    .nav-toggle-bars::after {
        content: "";
        position: absolute;
        left: 0;
    }

    .nav-toggle-bars::before {
        top: -7px;
    }

    .nav-toggle-bars::after {
        top: 7px;
    }

    .nav-open .nav-toggle-bars {
        background: transparent;
    }

    .nav-open .nav-toggle-bars::before {
        transform: translateY(7px) rotate(45deg);
    }

    .nav-open .nav-toggle-bars::after {
        transform: translateY(-7px) rotate(-45deg);
    }

    /* Il pannello: sotto l'intestazione, alto al piu' quanto lo schermo. */
    #nav {
        display: none;
        position: absolute;
        top: 100%;
        left: 0;
        right: 0;
        max-height: calc(100vh - 55px);
        overflow-y: auto;
        background: var(--color-on-primary);
        box-shadow: 0 8px 16px rgba(0, 0, 0, 0.25);
        border-radius: 0 0 var(--radius-medium) var(--radius-medium);
        z-index: 6;
    }

    .nav-open #nav {
        display: block;
    }

    .menu-main {
        flex-direction: column;
    }

    .menu-main > li > a {
        color: var(--color-on-dark);
        height: 46px;
        line-height: 46px;
        padding: 0 20px;
        border-bottom: 1px solid var(--color-bg-soft);
    }

    .menu-main > li > a:hover {
        color: var(--color-on-primary);
        background: linear-gradient(to bottom, var(--color-primary-light), var(--color-primary-mid));
    }

    /* Sottomenu: sempre in colonna sotto la voce, chiusi finche' la voce non
     * e' is-open (l'hover non apre nulla: al tocco resterebbe "incollato"). */
    .menu-main .dropdown {
        position: static;
        display: none;
        visibility: visible;
        opacity: 1;
        box-shadow: none;
        background: var(--color-bg-soft);
    }

    .menu-main .has-dropdown.is-open > .dropdown {
        display: block;
    }

    .menu-main .dropdown a {
        padding-left: 32px;
    }

    .menu-main .dropdown .dropdown a {
        padding-left: 48px;
    }

    /* Nel pannello le voci stanno in colonna e le icone non servono: spariscono
     * tutte, nella barra e nei sottomenu (le frecce dei sottomenu sono testo, non
     * icone). Una voce che nella barra e' solo un'icona ha il nome in un
     * .sr-only: qui diventa il testo visibile della voce. */
    .menu-main .icon {
        display: none;
    }

    .menu-main > li > a > .sr-only {
        position: static;
        width: auto;
        height: auto;
        margin: 0;
        clip: auto;
        overflow: visible;
    }

    /* La freccia della voce si gira quando il sottomenu e' aperto. */
    .menu-main .arrow-down {
        display: inline-block;
        transition: transform 0.15s ease;
    }

    .menu-main .is-open > a > .arrow-down {
        transform: rotate(180deg);
    }
}