/*
 * layout.css — Structures globales
 * Layer : layout
 * Role : topbar, footer, container, nav, grids principales
 * Doc : docs/CSS_ARCHITECTURE.md
 */

@layer layout {

  /* ════════════════════════════════════════════════════════════
   *  LE RAIL — colonnes latérales à deux zones
   * ════════════════════════════════════════════════════════════
   *
   *  .rail-flow   → défile avec la page (les pubs)
   *  .rail-pinned → collant, suit le défilement
   *
   *  Utilisé par les QUATRE colonnes du site :
   *    .right-col-sidebar      partials/right-col.php (+ variante thème)
   *    .home-sidebar           views/home.php (+ variante thème)
   *    .course-content-sidebar partials/blocks/course-sidebar.php
   *    .concours-sidebar       views/_concours-sidebar.php
   *
   *  POURQUOI DEUX ZONES (19/08/2026). Avant, la pub 300×600 était collante
   *  ET placée AVANT les cartes : en descendant elle se décollait et passait
   *  derrière elles, ressortant dans les trous entre deux cartes (les deux
   *  bandes bleues signalées sur l'accueil). Sur /direct/ elle traversait même
   *  la carte TRITURF, transparente à cause d'une variable manquante (corrigé
   *  dans themes/hippique.home.css).
   *  Un élément collant ne peut recouvrir que ses frères SUIVANTS : en mettant
   *  la zone collante EN DERNIER, le chevauchement devient impossible par
   *  construction, quel que soit le contenu qu'on y mettra plus tard.
   *  Même motif que .vip-side-stack (race-shared.css), qui avait résolu le
   *  même problème dans son coin — un collant par carte fait glisser les
   *  cartes les unes sur les autres, un collant sur le GROUPE ne le peut pas.
   *
   *  CE QU'ON GAGNE. Mesuré sur /direct/ en 1280×713 : la carte TRITURF
   *  commençait à y=816 et le bloc bookmakers à y=1016 — tous deux sous la
   *  ligne de flottaison, donc jamais vus sur un portable. Épinglés, ils
   *  restent à l'écran pendant les 8 900 px du fil.
   *
   *  CONTRAINTE POUR LA SUITE. La zone épinglée doit rester plus courte que
   *  l'écran, sinon son bas devient inatteignable. Place disponible sur un
   *  portable : 713 − 100 (décalage) − 16 (air) = 597 px. C'est la raison
   *  pour laquelle la pub 300×600 (628 px avec ses marges) n'est JAMAIS
   *  épinglée : elle ne rentre pas. TOUT NOUVEAU BLOC VA DANS .rail-flow.
   */

  /* ── LARGEUR DE LA COLONNE DU SITE : 300 px, un point c'est tout ──
     300 px, c'est la largeur des pavés publicitaires (300×600, 300×250).
     app.css laisse `.layout` à 320 px et QUATRE feuilles la ramènent à 300
     chacune dans son coin (direct.css, cotes.css, arrivees.css,
     course-day.css). Les pages qui n'ont pas de feuille dédiée — /communaute/,
     /outils/, et toute page future — restaient donc à 320 : la pub y flottait
     avec 10 px de vide de chaque côté pendant que les cartes, elles, faisaient
     bien 320. Mesuré sur /communaute/ : image à x=970 sur 300 px, carte à
     x=960 sur 320 px. La largeur est désormais écrite ICI, une seule fois.

     DANS LA MEDIA QUERY, ET C'EST OBLIGATOIRE : sous 1200 px `.layout` n'a
     aucune colonne déclarée (une seule colonne, la pub est masquée). Poser la
     règle hors media query couperait toutes les pages en deux sur mobile.

     `.layout.no-right-col` garde sa colonne unique : sa règle d'app.css est en
     `!important`, et un `!important` d'une couche inférieure l'emporte
     toujours sur une déclaration normale d'une couche supérieure.

     LES TROIS AUTRES COLONNES ÉTAIENT À 340 px (accueil, pages course,
     concours) : la pub y flottait avec 20 px de vide de chaque côté. Décision
     Xavier 19/08/2026 : 300 px partout, la largeur du pavé. Les cartes de
     l'accueil, dessinées à 340, sont donc 40 px plus étroites — c'est assumé.
     Ces trois-là vivent en @layer legacy (app.css, race-shared.css,
     concours.css), donc @layer layout les supplante sans !important. */
  @media (min-width: 1200px) {
    .layout,
    .home-shell,
    .course-content-shell {
      grid-template-columns: minmax(0, 1fr) 300px;
    }
  }

  /* Concours a SON PROPRE point de rupture, 980 px et pas 1200 (concours.css) :
     recopier 1200 ici laisserait sa colonne à 340 entre 980 et 1200. */
  @media (min-width: 980px) {
    .concours-shell {
      grid-template-columns: minmax(0, 1fr) 300px;
    }
  }

  .right-col-sidebar,
  .home-sidebar,
  .course-content-sidebar,
  .concours-sidebar {
    /* 92 px de barre bookmaker collante (.topbar-sticky-bookmaker, --sb-height)
       + 8 px d'air. L'ancien .ad-sidebar-sticky d'app.css valait 110 px, soit
       18 px de vide : ça flottait, alors que le contenu de gauche passe
       DIRECTEMENT sous la barre. Même valeur que .vip-side-stack.
       Si la hauteur de la barre bouge un jour, c'est ici et nulle part ailleurs.
       (--sb-height n'est pas réutilisable telle quelle : elle est déclarée sur
       .topbar-sticky-bookmaker, donc hors de portée des colonnes.) */
    --rail-pinned-top: 100px;

    /* SANS CETTE LIGNE, RIEN NE COLLE — c'est le défaut de fond, et il était
       le même sur les quatre colonnes : leurs conteneurs (.layout,
       .home-shell, .course-content-shell, .concours-shell) sont TOUS en
       `align-items: start`, donc la colonne ne fait que la hauteur de son
       contenu. Sur /direct/ : 1 075 px pour un fil de 7 954. Or un élément
       collant ne sort jamais de son parent — la pub décrochait après ~560 px
       et toute la colonne disparaissait pour les 7 000 px restants.
       Les colonnes n'ont ni fond ni bordure : l'étirement ne se voit pas. */
    align-self: stretch;
  }

  /* Gouttière entre blocs, reprise à l'identique de chaque feuille d'origine :
     0 pour la colonne du site (c'est un bloc, ses cartes se touchent), 14 px
     pour les trois colonnes en grille. */
  .right-col-sidebar {
    --rail-gap: 0px;
  }

  .home-sidebar,
  .course-content-sidebar,
  .concours-sidebar {
    --rail-gap: 14px;

    /* CES TROIS COLONNES SONT DES GRILLES, pas des blocs — et une grille
       étirée répartit sa hauteur libre sur ses rangées (`align-content` vaut
       `normal`, qui se comporte comme `stretch`). Sans cette ligne,
       l'étirement ci-dessus ferait gonfler les deux zones et la zone épinglée
       deviendrait plus haute que son contenu, donc moins libre de suivre. */
    align-content: start;
  }

  .rail-flow,
  .rail-pinned {
    display: grid;
    gap: var(--rail-gap, 0px);
    align-content: start;
  }

  /* UNE SEULE COLONNE, ET ELLE NE PEUT PAS DÉPASSER (31/08/2026).
     Mesuré sur l'accueil, viewport 1440 : `.home-sidebar` faisait bien ses
     300 px, mais TOUT son contenu faisait 314 px. Les 14 px de débordement se
     voyaient à l'œil nu, parce que la pub, elle, reste à 300 : les cartes
     ressortaient de 7 px de chaque côté et le texte du bloc bilan se coupait
     autrement que sur le reste du site (constaté par Xavier, captures à
     l'appui).

     LA CAUSE EST `contain-intrinsic-size`, PAS UNE LARGEUR ÉCRITE QUELQUE
     PART : `.home-sidebar-card` porte `content-visibility: auto` avec
     `contain-intrinsic-size: 280px` (app.css). Tant que la carte est hors
     écran, le navigateur lui prête 280 px de CONTENU — auxquels s'ajoutent
     ses 2×16 px de padding et 2×1 px de bordure : 314 px de largeur minimale.
     Une piste de grille `auto` se dimensionne sur ce minimum-là, donc la
     grille s'élargissait sous sa colonne. Chercher un « 314 » dans les
     feuilles n'aurait rien donné.

     `minmax(0, 1fr)` interdit à la piste de dépasser son conteneur. À poser
     sur les colonnes en grille ET sur les deux zones, sinon le débordement
     remonte d'un cran. `.right-col-sidebar` n'est pas concernée : c'est un
     bloc, ses enfants prennent naturellement sa largeur.

     ⚠️ SANS CETTE RÈGLE, LE DÉFAUT SE PROPAGERAIT : depuis le 31/08 les
     quatre colonnes posent les mêmes cartes `.home-sidebar-card`, donc les
     quatre déborderaient, pas seulement l'accueil. */
  .home-sidebar,
  .course-content-sidebar,
  .concours-sidebar,
  .rail-flow,
  .rail-pinned {
    grid-template-columns: minmax(0, 1fr);
  }

  /* LA CARTE QUI PORTE LA PUB N'A NI MARGE NI BORDURE (19/08/2026).
     Accueil, pages course et concours emballent le pavé dans une `.card`
     (`.home-sidebar-ad`, 14 px de padding + 1 px de bordure). Dans une colonne
     de 300 px, ça ne laisse que 270 px utiles : le navigateur RÉDUISAIT le
     300×600 en 270×540 — flou, et hors du format vendu à l'annonceur.
     On retire donc le décor autour du pavé : il occupe exactement les 300 px
     de la colonne, comme dans la colonne du site où la pub n'a jamais eu de
     carte autour d'elle. Le rendu des trois colonnes s'aligne sur celle-là. */
  .rail-flow > .home-sidebar-ad {
    padding: 0;
    border: 0;
    background: transparent;
    box-shadow: none;
  }

  /* La pub reprend sa place dans le flux — c'est la zone épinglée qui colle
     désormais. `.ad-sidebar-sticky` garde son nom : le balisage vient de
     partials/ads/sidebar.php et des vues, et la classe reste inoffensive
     ailleurs. Dans une colonne à deux zones, elle est explicitement neutre. */
  .rail-flow > .ad-sidebar-sticky {
    position: static;
  }

  /* PAS DE MARGE HAUTE — et c'est volontaire (Xavier, 19/08/2026).
     app.css posait `margin-top: 16px` sur la pub via
     `.right-col-sidebar > .ad-sidebar-sticky:first-child`. Cette règle ne
     s'applique plus (la pub n'est plus enfant direct de la colonne) et on ne
     la rejoue PAS : elle décalait la colonne de 16 px vers le bas alors que
     tout le reste de la page commence à la même ligne. Mesuré sur /direct/ :
     colonne de gauche, fil et colonne de droite démarrent tous à y=197 ; la
     pub, elle, démarrait à y=213. Ne pas « restaurer » cette marge. */

  .rail-pinned {
    position: sticky;
    /* Valeur de repli explicite : une variable introuvable rendrait `top`
       invalide, donc `auto` — et un `position: sticky` sans ancrage vertical
       ne colle plus du tout, il défile comme un bloc ordinaire. La panne
       serait donc SILENCIEUSE. C'est exactement le mécanisme qui avait rendu
       la carte TRITURF transparente ; on ne le refait pas. */
    top: var(--rail-pinned-top, 100px);
    /* Au-dessus des pubs (z-index: 1 en @layer legacy). L'ordre du DOM suffit
       déjà, c'est une ceinture en plus des bretelles. */
    z-index: 2;
  }

  /* ÉCRAN TROP COURT : on remet la zone dans le flux plutôt que de lui couper
     le bas — un bouton « Parier sur ZETURF » inatteignable serait pire qu'un
     bloc qui défile.

     UN SEUL SEUIL DEPUIS LE 31/08/2026, ET C'EST LA CONSÉQUENCE DIRECTE DE
     L'ALIGNEMENT DES QUATRE COLONNES. Il y en avait deux (700 px pour
     l'accueil, 600 px pour les autres) parce que les zones épinglées n'avaient
     pas le même contenu :

       accueil       580 px (3 cartes) → il lui faut 580 + 100 + 16 = 696 px
       /direct/      456 px (2 cartes) → il lui faut 572 px
       pages course  256 px (1 carte)  → il lui faut 372 px

     Les quatre zones portent maintenant EXACTEMENT les deux mêmes cartes
     (promo TRITURF + « Parier en ligne »), donc la même hauteur, donc le même
     seuil. Garder 600 px ailleurs serait un piège : sur le portable 1366×768,
     très répandu, le viewport fait ~660 px — l'accueil se décollerait et les
     trois autres resteraient collées avec le même contenu, bas de carte
     inatteignable. C'est précisément le défaut que ce garde-fou existe pour
     empêcher.

     MESURE DU 31/08/2026 (Chrome, viewport 1440×900, /concours/) : la zone
     épinglée fait 377 px — 200 px de carte TRITURF, 14 px de gouttière, 163 px
     de « Parier en ligne ». Il lui faut donc 377 + 100 + 16 = 493 px : le
     seuil de 700 px garde de la marge.
     ⚠️ Ne pas mesurer cette hauteur sans avoir fait défiler la zone à l'écran.
     Les deux cartes portent `content-visibility: auto` : tant qu'elles n'ont
     jamais été peintes, le navigateur leur prête la taille de repli
     (`contain-intrinsic-size: 280px` + décor = 314 px chacune, soit 642 px au
     lieu de 377). On a bien 642 en première mesure, et c'est un mirage.

     MESURE DU 06/11/2026 (Chrome, accueil, 1360×701 puis 1360×900) : la carte
     « Parier en ligne » reprend les trois blocs du header (version B de Xavier,
     partials/blocks/parier-en-ligne.php) — 367 px. Zone épinglée : 200 + 14 +
     367 = 581 px, il lui faut 581 + 100 + 16 = 697 px : le seuil de 700 px
     tient, À 3 PX PRÈS (lignes à 14 px, la taille réglée dans l'admin). Un texte
     plus long ne change rien à la hauteur : la ligne reste sur une ligne, coupée
     par « … ».
     SEUIL REMONTÉ À 735 PX LE MÊME JOUR : les logos de la carte passent dans un
     même cadre de 130 × 36 px (Xavier, choix 1 « même cadre » : « les autres aussi
     grands que PMU ») — +12 px par book, carte 403 px, zone épinglée 617 px, il
     lui faut 617 + 100 + 16 = 733 px. Écrans de 701 à 735 px de haut : la zone
     défile désormais avec la page (le 1366×768, ~650 px utiles, le faisait déjà).
     Un 4e bloc actif dans le header (+~107 px) ou une taille de ligne montée dans
     l'admin (18 px = +24 px), et il faudra le remonter encore.

     06/11/2026 — TRITURF SORT DE LA ZONE ÉPINGLÉE. Sa carte version B fait
     456 px (photo, écran du logiciel) : zone épinglée 456 + 14 + 403 = 873 px
     (886 sur l'accueil), il lui aurait fallu ~990 px d'écran. Mesuré à 1360 × 900
     après défilement (audit Codex) : zone de 100 à 972 px, bouton Genybet et
     « Comparer les bookmakers › » sous le bas de l'écran. Option 1 de Xavier :
     TRITURF passe en bas de .rail-flow dans les six colonnes ; la zone épinglée
     ne porte plus que « Parier en ligne » (~403 px, ~416 sur l'accueil), il lui
     faut ~532 px : le seuil de 735 px reste, avec de la marge.

     SI UNE COLONNE REÇOIT UN JOUR UNE ZONE ÉPINGLÉE PLUS HAUTE, c'est ici que
     ça se règle, et il faudra remonter le seuil pour tout le monde. */
  @media (max-height: 735px) {
    .rail-pinned {
      position: static;
    }
  }
}
