/**
 * Les jetons de Référencime : la SEULE source des valeurs de style (#2221).
 *
 * Une couleur, un rayon, un espacement, une ombre, une police ou une durée se
 * prend ICI, par son nom : `color: var(--ref-texte-secondaire)`, jamais par sa
 * valeur. Une retouche se fait une fois, dans ce fichier, et se voit sur tous
 * les écrans qui lisent le jeton. On la voit d'abord sur la page « Composants »
 * de l'administration (Mes sites › Charte graphique) : elle lit CE fichier pour
 * afficher chaque jeton, et permet d'essayer une valeur sans rien enregistrer.
 *
 * ── Où il est chargé ──
 *   • sur toutes les pages d'administration ;
 *   • sur toute page publique qui charge une feuille du greffon ;
 *   • la page publique de la charte y lit, côté serveur, les couleurs qu'elle montre.
 * Sa version est la date du fichier : une retouche est servie partout aussitôt.
 *
 * ── Règles ──
 *   • un jeton par RÔLE, pas par teinte : « --ref-texte-secondaire », jamais
 *     « --ref-gris-646d8c » ;
 *   • le navy, la framboise et l'or viennent du thème (--secondary-color,
 *     --main-color, --gold-color) ; leur repli est la même valeur, pour les pages
 *     servies sans le thème ;
 *   • un jeton dérivé se calcule depuis un autre (color-mix), il ne recopie pas
 *     sa valeur : changer le navy change ses gris ;
 *   • une déclaration par ligne, suivie de son rôle en commentaire, et un titre
 *     « ── … ── » par famille : la page « Composants » les lit ainsi ;
 *   • les valeurs sont celles de la charte (docs/BRAND.md) : un écran qui en
 *     diffère est de la dette (docs/DESIGN_SYSTEM.md), pas une raison d'ajouter
 *     un jeton.
 *
 * Ce fichier est le seul du greffon où une couleur s'écrit en clair : le test
 * des couleurs en dur (tests/Unit/CouleursEnDurTest.php) compte les autres.
 */
:root {
    /* ── Marque ── */
    --ref-navy: var(--secondary-color, #222e5a); /* La dominante : fonds, titres, aplats, boutons, en-têtes de tableau. */
    --ref-navy-rgb: var(--secondary-color-rgb, 34, 46, 90); /* Le navy en trois nombres, pour les recettes rgba() existantes. Un jeton neuf se dérive par color-mix(). */
    --ref-framboise: var(--main-color, #cd2753); /* L'accent ponctuel : un mot, un trait, un état actif. Jamais une surface. */
    --ref-or: var(--gold-color, #c9a227); /* L'exceptionnel : « Pépite », « Recommandé ». Rare par principe ; jamais en texte sur fond clair. */
    --ref-blanc: #fff; /* Les surfaces, et le texte posé sur un aplat coloré. */
    --ref-encre: #313332; /* Le texte courant sur fond clair. */

    /* ── Neutres : du navy dilué ── */
    --ref-encre-titre: color-mix(in srgb, var(--ref-navy) 92%, #000); /* Titres et chiffres sur fond clair. */
    --ref-texte-secondaire: color-mix(in srgb, var(--ref-navy) 70%, #fff); /* Le plus clair permis pour du texte. */
    --ref-bordure: color-mix(in srgb, var(--ref-navy) 10%, transparent); /* Le contour des cartes et des blocs. */
    --ref-bordure-forte: color-mix(in srgb, var(--ref-navy) 18%, transparent); /* Un contour renforcé : séparateur, carte survolée. */
    --ref-bordure-controle: color-mix(in srgb, var(--ref-navy) 30%, transparent); /* Le contour d'un champ, d'un bouton en contour. */
    --ref-fond-doux: color-mix(in srgb, var(--ref-navy) 3%, #fff); /* Le fond d'un encart, d'une étape, d'une ligne sur deux. */

    /* ── États ── */
    --ref-succes: #1a8754; /* Ce qui est fait, actif, réussi. En texte sur blanc (sur le fond doux : en gras), ou en pastille teintée. */
    --ref-attention: #b45309; /* Ce qui demande un geste bientôt : une échéance, une limite. */
    --ref-erreur: #b02a2c; /* Ce qui a échoué ou bloque. */

    /* ── Prix ── */
    --ref-prix: #0d7d4c; /* Un montant, en gras, sur fond clair. Jamais sur le navy, jamais une surface. */

    /* ── Notes du classement ── */
    --ref-note-aplus: #2e7d32; /* La note A+ : fond de sa pastille, texte blanc. */
    --ref-note-a: #4caf50; /* La note A. Dette connue : le blanc s'y lit mal. */
    --ref-note-b: #2196f3; /* La note B. Dette connue : le blanc s'y lit mal. */
    --ref-note-c: #ff9800; /* La note C. Dette connue : le blanc s'y lit mal. */
    --ref-note-pepite: var(--ref-or); /* « Pépite » : l'or, et lui seul. */

    /* ── Rayons ── */
    --ref-rayon-petit: 4px; /* Un petit conteneur. */
    --ref-rayon-action: 5px; /* Le bouton d'action d'écran, rectangulaire. */
    --ref-rayon-controle: 10px; /* Un bouton secondaire, un champ. */
    --ref-rayon-carte: 16px; /* Une carte, une étape. */
    --ref-rayon-bloc: 24px; /* Un grand bloc, un bandeau d'ouverture. */
    --ref-rayon-pilule: 999px; /* Le bouton principal, une pastille. */

    /* ── Espacements ── */
    --ref-espace-1: 4px; /* Entre une icône et son texte. */
    --ref-espace-2: 8px; /* Entre deux éléments d'une même ligne. */
    --ref-espace-3: 12px; /* Le rembourrage d'une pastille large, d'une cellule. */
    --ref-espace-4: 16px; /* Le rembourrage d'une carte compacte. */
    --ref-espace-5: 20px; /* Entre deux blocs voisins. */
    --ref-espace-6: 24px; /* Le rembourrage d'une carte, entre deux sections. */

    /* ── Relief ── */
    --ref-ombre: 0 1px 3px color-mix(in srgb, var(--ref-navy) 4%, transparent), 0 8px 24px color-mix(in srgb, var(--ref-navy) 5%, transparent); /* Au repos : une ombre courte pour le contact, une longue pour la hauteur. Jamais d'ombre noire. */
    --ref-ombre-survol: 0 2px 6px color-mix(in srgb, var(--ref-navy) 6%, transparent), 0 16px 36px color-mix(in srgb, var(--ref-navy) 9%, transparent); /* Au survol, quand la carte s'élève de 2 à 4 px. */

    /* ── Typographie ── */
    --ref-police: 'Roboto', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; /* La police du produit, auto-hébergée par le thème. */
    --ref-police-mono: ui-monospace, SFMono-Regular, Menlo, monospace; /* Une clé, un code, une valeur à copier. */
    --ref-graisse-extra-fine: 200; /* Les grands titres. */
    --ref-graisse-fine: 300; /* Le texte courant, les grands chiffres. */
    --ref-graisse-normale: 400; /* L'emphase, les titres d'écran. */
    --ref-graisse-moyenne: 500; /* Les petits labels, les boutons. */
    --ref-graisse-forte: 700; /* L'exceptionnel. Jamais 600 ni 800 : ces graisses ne sont pas chargées. */

    /* ── Mouvement ── */
    --ref-courbe: cubic-bezier(.2, .7, .2, 1); /* Démarre vite, se pose lentement. */
    --ref-duree-courte: 150ms; /* Un changement d'état : couleur, opacité. */
    --ref-duree: 200ms; /* Le mouvement ordinaire. */
    --ref-duree-longue: 280ms; /* Une élévation, une ouverture. */

    /* ── Contrôles ── */
    --ref-hauteur-controle: 40px; /* Un bouton d'action, un champ, un sélecteur. */
}
