/* ═══════════════════════════════════════════════════════════════
   DOCUMENTATION
   ═══════════════════════════════════════════════════════════════

   Une page de texte. Ce qui compte ici est la lisibilite : une
   largeur de lecture bornee, une hierarchie de titres franche, et
   des tableaux qui se lisent --- la documentation en est pleine.

   Trois colonnes quand la place le permet : le sommaire des
   documents a gauche, le texte au milieu, le plan de la page a
   droite. En dessous de 1200 px, les deux colonnes laterales
   passent au-dessus du texte.
   ═══════════════════════════════════════════════════════════════ */

.doc-shell{
    display: grid;
    grid-template-columns: 250px minmax(0, 1fr) 210px;
    gap: var(--space-6);
    padding: var(--space-6);
    align-items: start;
}

/* ── Le sommaire ─────────────────────────────────────────────── */

.doc-nav{
    position: sticky; top: var(--space-6);
    background: #fff; border: 1px solid var(--grey-200);
    border-radius: var(--radius-lg); padding: var(--space-4);
    max-height: calc(100vh - var(--space-12)); overflow-y: auto;
}
.doc-nav-title{
    font-size: .65rem; font-weight: 800; text-transform: uppercase;
    letter-spacing: .08em; color: var(--grey-400);
    padding-bottom: var(--space-3); margin-bottom: var(--space-2);
    border-bottom: 1px solid var(--grey-100);
}
/* Un groupe se replie. Sans cela, quarante liens a plat annulent le gain
   qu'il y avait a decouper les pages. Le groupe qui contient la page
   courante s'ouvre seul : c'est doc.php qui pose l'attribut « open ». */
.doc-nav-groupe{ margin: var(--space-3) 0 0; }
.doc-nav-groupe > summary{ cursor: pointer; list-style: none; }
.doc-nav-groupe > summary::-webkit-details-marker{ display: none; }

.doc-nav-section{
    font-size: .62rem; font-weight: 800; text-transform: uppercase;
    letter-spacing: .06em; color: var(--grey-400);
    margin: 0 0 var(--space-2); padding: 4px 8px 4px 20px;
    border-radius: var(--radius-sm); position: relative;
}
.doc-nav-groupe > summary:hover{ background: var(--grey-50); color: var(--grey-700); }

/* Le chevron, dessine en CSS : une fleche de plus a charger pour un triangle
   serait du poids pour rien. */
.doc-nav-section::before{
    content: ''; position: absolute; left: 7px; top: 50%;
    width: 5px; height: 5px; margin-top: -3px;
    border-right: 1.5px solid currentColor; border-bottom: 1.5px solid currentColor;
    transform: rotate(-45deg); transition: transform .15s ease;
}
.doc-nav-groupe[open] > summary .doc-nav-section::before,
.doc-nav-groupe[open] > summary.doc-nav-section::before{ transform: rotate(45deg); }
.doc-nav-groupe[open] > summary{ color: var(--grey-600); }

.doc-nav-item{
    display: block; padding: 6px 8px 6px 20px; border-radius: var(--radius-sm);
    font-size: .8rem; font-weight: 600; color: var(--grey-600);
    text-decoration: none; line-height: 1.35;
}
.doc-nav-item:hover{ background: var(--grey-50); color: var(--grey-900); }
.doc-nav-item.active{ background: var(--psg-navy); color: #fff; font-weight: 700; }

/* Un document hors groupe — l'accueil — n'a pas de titre au-dessus de lui. */
.doc-nav-seul{ padding-left: 8px; }

/* Le cote technique ferme chaque groupe, et se voit comme tel : c'est la
   page qu'un lecteur metier peut sauter sans rien perdre. */
.doc-nav-technique{
    color: var(--psg-red); margin-top: 2px;
    border-top: 1px solid var(--grey-100); padding-top: 8px;
}
.doc-nav-technique:hover{ background: #fdf0ef; color: var(--psg-red-dark); }
.doc-nav-technique.active{ background: var(--psg-red); color: #fff; }

/* ── Le texte ────────────────────────────────────────────────── */

.doc-body{
    background: #fff; border: 1px solid var(--grey-200);
    border-radius: var(--radius-lg); padding: var(--space-8);
    min-width: 0;   /* sans quoi un tableau large deborde la grille */
    font-size: .92rem; line-height: 1.65; color: var(--grey-700);
}
.doc-source{
    font-size: .72rem; color: var(--grey-400); font-weight: 600;
    padding-bottom: var(--space-4); margin-bottom: var(--space-5);
    border-bottom: 1px solid var(--grey-100);
}
.doc-source code{ background: var(--grey-50); padding: 1px 5px; border-radius: 3px; }

.doc-body h1{
    font-size: 1.7rem; font-weight: 900; color: var(--grey-900);
    line-height: 1.2; margin: 0 0 var(--space-5);
}
.doc-body h2{
    font-size: 1.15rem; font-weight: 800; color: var(--psg-navy);
    margin: var(--space-8) 0 var(--space-3);
    padding-bottom: var(--space-2); border-bottom: 2px solid var(--grey-100);
}
.doc-body h3{
    font-size: .95rem; font-weight: 800; color: var(--grey-800);
    margin: var(--space-6) 0 var(--space-2);
}
.doc-body h4{
    font-size: .85rem; font-weight: 800; color: var(--grey-600);
    text-transform: uppercase; letter-spacing: .04em;
    margin: var(--space-5) 0 var(--space-2);
}
.doc-body p{ margin: 0 0 var(--space-4); max-width: 78ch; }
.doc-body ul, .doc-body ol{ margin: 0 0 var(--space-4); padding-left: var(--space-6); max-width: 78ch; }
.doc-body li{ margin-bottom: 4px; }
.doc-body a{ color: var(--psg-gold-dark); font-weight: 600; }
.doc-body a:hover{ color: var(--psg-navy); }
.doc-body strong{ color: var(--grey-900); font-weight: 800; }
.doc-body hr{ border: 0; border-top: 1px solid var(--grey-200); margin: var(--space-8) 0; }

.doc-body code{
    font-family: var(--font-mono); font-size: .84em;
    background: var(--grey-50); border: 1px solid var(--grey-100);
    border-radius: 3px; padding: 1px 5px; color: var(--psg-navy);
}
.doc-body pre{
    position: relative;
    background: var(--psg-navy); color: #e2e8f0;
    border-radius: var(--radius-md); padding: var(--space-4) var(--space-5);
    overflow-x: auto; margin: 0 0 var(--space-4); line-height: 1.5;
}
.doc-body pre code{
    background: none; border: 0; padding: 0; color: inherit; font-size: .8rem;
}
.doc-copy{
    position: absolute; top: 8px; right: 8px;
    background: rgba(255,255,255,.1); border: 1px solid rgba(255,255,255,.2);
    color: #e2e8f0; border-radius: 5px; padding: 3px 9px;
    font-family: var(--font-sans); font-size: .66rem; font-weight: 700;
    cursor: pointer; opacity: 0; transition: opacity .15s;
}
.doc-body pre:hover .doc-copy{ opacity: 1; }
.doc-copy:hover{ background: rgba(255,255,255,.2); }

/* Une citation sert ici aux avertissements et aux « a completer ». */
.doc-body blockquote{
    margin: 0 0 var(--space-4); padding: var(--space-4) var(--space-5);
    background: #fffbeb; border-left: 3px solid var(--warning);
    border-radius: 0 var(--radius-md) var(--radius-md) 0;
    color: var(--grey-700);
}
.doc-body blockquote strong{ color: #92400e; }

.doc-body table{
    width: 100%; border-collapse: collapse; margin: 0 0 var(--space-5);
    font-size: .84rem;
}
.doc-body th{
    text-align: left; padding: var(--space-2) var(--space-3);
    font-size: .68rem; font-weight: 800; text-transform: uppercase;
    letter-spacing: .04em; color: var(--grey-500);
    border-bottom: 2px solid var(--grey-200); white-space: nowrap;
}
.doc-body td{
    padding: var(--space-2) var(--space-3);
    border-bottom: 1px solid var(--grey-100); vertical-align: top;
}
.doc-body tbody tr:hover{ background: var(--grey-50); }

/* ── Le plan de la page ──────────────────────────────────────── */

.doc-plan{
    position: sticky; top: var(--space-6);
    max-height: calc(100vh - var(--space-12)); overflow-y: auto;
}
.doc-plan-title{
    font-size: .62rem; font-weight: 800; text-transform: uppercase;
    letter-spacing: .06em; color: var(--grey-400); margin-bottom: var(--space-3);
}
.doc-plan-item{
    display: block; padding: 3px 0 3px 10px;
    border-left: 2px solid var(--grey-200);
    font-size: .76rem; color: var(--grey-500); text-decoration: none;
    line-height: 1.35;
}
.doc-plan-item:hover{ color: var(--grey-800); }
.doc-plan-item.active{ color: var(--psg-navy); border-left-color: var(--psg-navy); font-weight: 700; }
.doc-plan-n3{ padding-left: 20px; font-size: .72rem; }

@media (max-width: 1200px){
    .doc-shell{ grid-template-columns: 220px minmax(0, 1fr); }
    .doc-plan{ display: none; }
}
@media (max-width: 860px){
    .doc-shell{ grid-template-columns: 1fr; padding: var(--space-4); }
    .doc-nav{ position: static; max-height: none; }
    .doc-body{ padding: var(--space-5); }
}