/*
Theme Name:        Discovery
Theme URI:         https://ramalikibi.com/dev/discovery-theme/
Author:            Rama Likibi Elomi
Author URI:        https://ramalikibi.com/
Description:       Thème général et agnostique. Architecture à zones en en-tête et en pied de page, rendu intégralement piloté par hooks, accessibilité WCAG 2.1 niveau AA, typographie fluide, mobile-first. Personnalisable sans thème enfant via son API de hooks.
Version:           1.0.2
Requires at least: 6.0
Tested up to:      6.9
Requires PHP:      8.3
License:           GNU General Public License v3 or later
License URI:       https://www.gnu.org/licenses/gpl-3.0.html
Text Domain:       discovery
Tags:              custom-logo, custom-menu, custom-colors, custom-background, featured-images, translation-ready, block-styles, wide-blocks, accessibility-ready, threaded-comments, footer-widgets, right-sidebar, left-sidebar
*/


/* =============================================================
   1. Variables racines
   ============================================================= */

:root {

    /*
     * Couleurs de base, surchargées par le Customizer.
     *
     * Les rapports de contraste sur le fond sont de 21:1 pour le texte,
     * 10:1 pour le texte atténué et les liens, 3:1 pour les bordures. Le
     * critère WCAG 2.1 1.4.3 exige 4,5:1 pour du texte et le critère 1.4.11
     * exige 3:1 pour les éléments d'interface.
     */
    --discovery-color-text: #ffffff;
    --discovery-color-background: #000000;
    --discovery-color-surface: #141414;
    --discovery-color-border: #595959;
    --discovery-color-muted: #b3b3b3;
    --discovery-color-link: #7fb8ff;
    --discovery-color-link-hover: #b3d4ff;
    --discovery-color-accent: #d69bff;

    /*
     * Couleurs des messages.
     *
     * Employées comme bordure latérale des messages de l'espace de compte.
     * Sur la surface des messages, elles atteignent 9,07:1, 11,31:1 et
     * 8,95:1, au-dessus des 3:1 qu'exige le critère WCAG 1.4.11.
     */
    --discovery-color-erreur: #ff9b8f;
    --discovery-color-succes: #7ddf9a;
    --discovery-color-info: #7fb8ff;

    /*
     * Points de rupture mobile-first.
     *
     * Ces variables ne sont pas utilisables dans une règle @media : la
     * spécification CSS interdit var() dans une condition de media query.
     * Elles servent uniquement aux calculs en CSS, notamment dans clamp(),
     * et à la lecture par le JavaScript via getComputedStyle. Les valeurs
     * littérales correspondantes sont répétées dans les règles @media des
     * feuilles dédiées de assets/css/.
     */
    --discovery-bp-xs: 320px;
    --discovery-bp-sm: 480px;
    --discovery-bp-fold: 640px;
    --discovery-bp-md: 768px;
    --discovery-bp-lg: 1024px;
    --discovery-bp-xl: 1280px;
    --discovery-bp-2xl: 1536px;

    /* Pile de polices système. */
    --discovery-font-system: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;

    /* Pile de polices à chasse fixe. */
    --discovery-font-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace;

    /*
     * Police du thème.
     *
     * Déclarée par la feuille des polices, chargée avant celle-ci.
     */
    --discovery-font-theme: "InterVariable";

    /*
     * Police de repli ajustée aux dimensions de la police du thème.
     *
     * Déclarée par la feuille des polices. Elle redimensionne une police déjà
     * installée sur la machine pour qu'elle rende à la même échelle, de sorte
     * que le texte occupe la même place avant et après le remplacement.
     */
    --discovery-font-repli: "InterVariable Repli";

    /*
     * Police active, réaffectée par le module de polices.
     *
     * Les trois familles se succèdent : la police du thème, son repli ajusté
     * tant que le fichier n'est pas chargé, puis la pile système sur une
     * machine dépourvue des polices que le repli redimensionne.
     */
    --discovery-font-active: var(--discovery-font-theme), var(--discovery-font-repli), var(--discovery-font-system);

    /*
     * Graisses de la police.
     *
     * La police du thème est variable et couvre la plage de cent à neuf
     * cents. Trois graisses sont nommées : celle du texte courant, celle des
     * éléments mis en avant, et celle que les navigateurs donnent aux titres.
     */
    --discovery-weight-normal: 400;
    --discovery-weight-semibold: 600;
    --discovery-weight-bold: 700;

    /* Tailles de texte fluides via clamp(). */
    --discovery-text-xs: clamp(0.75rem, 0.70rem + 0.20vw, 0.875rem);
    --discovery-text-sm: clamp(0.875rem, 0.80rem + 0.30vw, 1rem);
    --discovery-text-base: clamp(1rem, 0.92rem + 0.40vw, 1.25rem);
    --discovery-text-lg: clamp(1.125rem, 1.00rem + 0.60vw, 1.375rem);
    --discovery-text-xl: clamp(1.25rem, 1.05rem + 1.00vw, 1.75rem);
    --discovery-text-2xl: clamp(1.50rem, 1.20rem + 1.50vw, 2.25rem);
    --discovery-text-3xl: clamp(1.875rem, 1.40rem + 2.40vw, 3rem);
    --discovery-text-4xl: clamp(2.25rem, 1.60rem + 3.20vw, 4rem);

    /* Hauteurs de ligne. */
    --discovery-line-tight: 1.2;
    --discovery-line-normal: 1.5;
    --discovery-line-loose: 1.75;

    /* Échelle d'espacements. */
    --discovery-space-0: 0;
    --discovery-space-1: 0.25rem;
    --discovery-space-2: 0.5rem;
    --discovery-space-3: 0.75rem;
    --discovery-space-4: 1rem;
    --discovery-space-5: 1.25rem;
    --discovery-space-6: 1.5rem;
    --discovery-space-8: 2rem;
    --discovery-space-10: 2.5rem;
    --discovery-space-12: 3rem;
    --discovery-space-16: 4rem;
    --discovery-space-20: 5rem;

    /* Rayons de bordure. */
    --discovery-radius-none: 0;
    --discovery-radius-sm: 0.25rem;
    --discovery-radius-md: 0.5rem;
    --discovery-radius-lg: 1rem;
    --discovery-radius-full: 9999px;

    /*
     * Indicateur de focus clavier.
     *
     * La couleur est explicite et non currentColor : le critère WCAG 2.1
     * 1.4.11 exige un rapport de contraste de 3:1 entre l'indicateur de
     * focus et l'arrière-plan adjacent, ce que currentColor ne garantit pas
     * lorsque le texte et le fond sont proches.
     */
    --discovery-focus-width: 3px;
    --discovery-focus-offset: 2px;
    --discovery-focus-color: #ffb454;

    /* Durées de transition. */
    --discovery-duration-fast: 120ms;
    --discovery-duration-normal: 240ms;
    --discovery-duration-slow: 400ms;

    /*
     * Largeurs maximales, par nature de contenu.
     *
     * L'enveloppe borne l'en-tête, la zone de contenu et le pied de page.
     * La largeur ample borne ce qui se parcourt du regard : grilles, cartes,
     * tableaux, panneaux. La largeur de lecture borne le texte courant.
     *
     * La largeur de lecture est calculée sur la police du thème, dont un
     * caractère mesure en moyenne 0,4748 cadratin une fois pondéré par la
     * fréquence des lettres en français. À 672 pixels, la ligne compte donc
     * de 71 à 79 caractères selon la taille du texte, qui varie avec la
     * fenêtre. La fourchette de lecture confortable s'étend de 45 à 75
     * caractères, et le critère WCAG 1.4.8 fixe le plafond à 80.
     */
    --discovery-content-max: 85rem;
    --discovery-large-max: 60rem;
    --discovery-lecture-max: 42rem;

    /* Largeur de la colonne latérale. */
    --discovery-sidebar-width: 20rem;

    /*
     * Largeurs maximales propres aux modèles de page.
     *
     * Le modèle Parcours et le modèle Connexion resserrent le contenu : une
     * ligne trop longue nuit à la lecture, et ces deux modèles présentent
     * des contenus qui demandent une attention continue.
     */
    --discovery-parcours-max: 55rem;
    --discovery-connexion-max: 34rem;

    /* Dimensions maximales des images d'interface. */
    --discovery-logo-max-height: 6rem;
    --discovery-logo-connexion-max: 12rem;
    --discovery-vignette-dialogue-max: 4rem;

    /*
     * Marge de défilement appliquée aux cibles d'ancres.
     *
     * Évite qu'un en-tête fixe recouvre l'élément atteint après activation
     * d'un lien d'évitement ou d'une ancre interne.
     */
    --discovery-scroll-margin: var(--discovery-space-8);
}


/* =============================================================
   2. Reset moderne
   ============================================================= */

/* Modèle de boîte uniforme. */
*,
*::before,
*::after {
    box-sizing: border-box;
}

/* Réinitialisation des marges des éléments structurels. */
html,
body,
h1,
h2,
h3,
h4,
h5,
h6,
p,
figure,
blockquote,
dl,
dd {
    margin: 0;
    padding: 0;
}

/* Comportement de défilement et ajustement de taille de texte. */
html {
    scroll-behavior: smooth;
    text-size-adjust: 100%;
    -webkit-text-size-adjust: 100%;
}

/* Corps de page. */
body {
    min-height: 100vh;
    min-height: 100dvh;
    color: var(--discovery-color-text);
    background-color: var(--discovery-color-background);
    font-family: var(--discovery-font-active);
    font-size: var(--discovery-text-base);
    line-height: var(--discovery-line-normal);
    text-rendering: optimizeLegibility;
}

/* Médias responsives. */
img,
picture,
video,
canvas,
svg {
    display: block;
    max-width: 100%;
    height: auto;
}

/* Héritage typographique sur les champs de formulaire. */
input,
button,
textarea,
select {
    font: inherit;
    color: inherit;
}

/*
 * Liens.
 *
 * Le soulignement est conservé. Le critère WCAG 2.1 1.4.1 impose qu'un lien
 * situé dans un bloc de texte soit distinguable autrement que par la couleur
 * seule. Les composants qui n'ont pas besoin du soulignement, comme la
 * navigation ou les boutons, le retirent dans leur propre feuille.
 */
a {
    color: var(--discovery-color-link);
    text-decoration: underline;
    text-underline-offset: 0.15em;
}

a:hover,
a:focus {
    color: var(--discovery-color-link-hover);
}

/*
 * Listes.
 *
 * Seules les marges et le retrait sont réinitialisés. Le retrait des puces
 * n'est volontairement pas global : sous Safari, list-style: none supprime
 * la sémantique de liste restituée par VoiceOver, qui n'annonce alors plus
 * ni la nature de liste ni le nombre d'éléments. Les composants qui retirent
 * les puces doivent le faire dans leur propre feuille et porter role="list"
 * sur l'élément concerné pour rétablir la sémantique.
 */
ul,
ol {
    margin: 0;
    padding: 0;
}

/* Tableaux. */
table {
    border-collapse: collapse;
    border-spacing: 0;
}

/* Élément dialog neutralisé. */
dialog {
    border: 0;
    padding: 0;
    color: inherit;
    background: transparent;
}

/* Masquage de l'élément dialog à l'état fermé. */
dialog:not([open]) {
    display: none;
}


/* =============================================================
   3. Position de la colonne latérale
   ============================================================= */

/*
 * La colonne latérale est placée après le contenu principal dans le
 * document, et cet ordre n'est jamais modifié : atteindre le contenu ne doit
 * pas supposer de traverser des éléments complémentaires, au clavier comme à
 * la lecture linéaire.
 *
 * La classe d'inversion ne change que le placement visuel des colonnes. Elle
 * est prévue pour un réglage de thème, et n'a d'effet qu'à partir de la
 * largeur où les deux colonnes coexistent.
 */
@media (min-width: 1024px) {

    .discovery-sidebar-inversee .discovery-content-area:has(.discovery-sidebar) {
        grid-template-columns: minmax(0, var(--discovery-sidebar-width)) minmax(0, 1fr);
    }

    .discovery-sidebar-inversee .discovery-main {
        grid-column: 2;
    }

    .discovery-sidebar-inversee .discovery-sidebar {
        grid-row: 1;
        grid-column: 1;
    }
}


/* =============================================================
   4. Accessibilité de base et préférences utilisateur
   ============================================================= */

/* Indication visible du focus clavier. */
:focus-visible {
    outline: var(--discovery-focus-width) solid var(--discovery-focus-color);
    outline-offset: var(--discovery-focus-offset);
}

/* Dégagement sous un en-tête fixe pour toute cible d'ancre. */
:target {
    scroll-margin-block-start: var(--discovery-scroll-margin);
}

/*
 * Masquage visuel accessible aux lecteurs d'écran.
 *
 * L'élément reste dans l'arbre d'accessibilité et reste restitué par
 * VoiceOver, contrairement à display: none ou visibility: hidden.
 */
.discovery-visually-hidden {
    position: absolute;
    width: 1px;
    height: 1px;
    padding: 0;
    margin: -1px;
    overflow: hidden;
    clip-path: inset(50%);
    white-space: nowrap;
    border: 0;
}

/*
 * Variante révélée au focus clavier, pour les liens d'évitement.
 *
 * L'élément masqué redevient visible et positionné dès qu'il reçoit le
 * focus, ce qu'exige le critère WCAG 2.1 2.4.1 pour un lien d'évitement
 * utilisable au clavier.
 */
.discovery-visually-hidden-focusable:not(:focus):not(:focus-within) {
    position: absolute;
    width: 1px;
    height: 1px;
    padding: 0;
    margin: -1px;
    overflow: hidden;
    clip-path: inset(50%);
    white-space: nowrap;
    border: 0;
}

/* Respect de la préférence prefers-reduced-motion. */
@media (prefers-reduced-motion: reduce) {

    html {
        scroll-behavior: auto;
    }

    *,
    *::before,
    *::after {
        animation-duration: 0.01ms !important;
        animation-iteration-count: 1 !important;
        transition-duration: 0.01ms !important;
        scroll-behavior: auto !important;
    }
}

/* Respect de la préférence prefers-contrast. */
@media (prefers-contrast: more) {

    :root {
        --discovery-color-text: #ffffff;
        --discovery-color-background: #000000;
        --discovery-color-surface: #000000;
        --discovery-color-muted: #ffffff;
        --discovery-color-border: #ffffff;
        --discovery-color-link: #b3d4ff;
        --discovery-color-link-hover: #ffffff;
        --discovery-color-accent: #ffffff;
        --discovery-color-erreur: #ffffff;
        --discovery-color-succes: #ffffff;
        --discovery-color-info: #ffffff;
    }
}