/* KnowSpace — Le kit d'une page de doc : sa mise en page, sa recherche et son sommaire
   (templates/_toc.html, static/toc.js)

   Sur ordinateur, la recherche et le sommaire à gauche de la page, tenus à l'écran pendant la
   lecture, le sommaire replié par rubrique, sans défilement à lui. Sur téléphone, une barre collée
   en haut de l'écran, « Rechercher » et « Sommaire » côte à côte, le sommaire ouvert par-dessus la
   page. Venu du guide de TimeAcappella (2026-10-22).

   Brique commune : le guide de TimeAcappella copie ce fichier et toc.js tels quels
   (`python3 build.py sync kit`, server/www/kit/) et son `test server` échoue tant que sa copie
   diffère d'ici. Ce qui est propre aux pages de knowspace (largeur de la page, pied, accueil) va
   dans style.css, jamais ici.

   Le HTML attendu (templates/_toc.html le produit) :
     .ks-layout                         la grille : la colonne, puis la page (<main>, <article>…)
       .ks-side                         la colonne, ou la barre sur téléphone
         .ks-search [hidden]            le champ, montré par le script de la recherche
           svg, input.ks-search__input, .ks-search__results [hidden] (des <a> avec <b> et
           éventuellement <span>, ou un <p> sans résultat), .ks-search__status [role=status]
         nav.ks-toc > details.ks-toc__contents[data-ks-contents] > summary + .ks-toc__body
           a.ks-toc__home, ul > li > a[aria-current="page"],
           details.ks-toc__part[name="ks-toc-<profondeur>"] > summary + ul (+ sous-rubriques)
   Les couleurs, celles de la page hôte : --ks-text, --ks-text-light, --ks-bg, --ks-bg-secondary,
   --ks-accent, --ks-header-bg (les ombres, les titres des résultats) ; --ks-field-bg (le champ) et
   --ks-panel-bg (les résultats, le sommaire sur téléphone) au besoin, --ks-bg sinon. La marge de la
   page sur téléphone : 16 px de chaque côté (la barre en prend toute la largeur). */

/* La colonne, puis la page */
.ks-layout {
    display: grid;
    grid-template-columns: minmax(0, 1fr);
    gap: 20px;
}

.ks-side {
    position: sticky;
    top: 0;
    z-index: 30;
    display: flex;
    align-items: center;
    gap: 8px;
    margin-inline: -16px;
    padding: 10px 16px;
    border-bottom: 1px solid color-mix(in oklab, var(--ks-text) 10%, transparent);
    background: var(--ks-bg);
}

.ks-side .ks-search {
    flex: 1;
    min-width: 0;
    margin: 0;
}

.ks-toc {
    flex: none;
    margin-left: auto;
}

@media (max-width: 959.98px) {
    .ks-toc {
        padding-top: 0;
    }

    .ks-toc__contents > summary {
        white-space: nowrap;
    }

    .ks-toc__contents[open] > summary {
        border-color: var(--ks-accent);
        background: color-mix(in oklab, var(--ks-accent) 12%, transparent);
    }

    /* Le sommaire par-dessus la page, sous « Sommaire », défilant seul quand il est plus long que
       l'écran (c'est un menu, plus une colonne) */
    .ks-toc__body {
        position: absolute;
        top: calc(100% + 6px);
        right: 16px;
        width: min(28rem, calc(100% - 32px));
        max-height: calc(100dvh - 96px);
        overflow-y: auto;
        overscroll-behavior: contain;
        padding: 18px 20px;
        border: 1px solid color-mix(in oklab, var(--ks-text) 16%, transparent);
        border-radius: 14px;
        background: var(--ks-panel-bg, var(--ks-bg));
        box-shadow: 0 16px 40px color-mix(in oklab, var(--ks-header-bg) 22%, transparent);
    }

    /* Un titre atteint par un lien arrive sous la barre, pas derrière */
    .ks-layout :is(h2, h3) {
        scroll-margin-top: 88px;
    }
}

@media (min-width: 960px) {
    .ks-layout {
        grid-template-columns: 20rem minmax(0, 1fr);
        gap: 64px;
        align-items: start;
    }

    .ks-side {
        top: 24px;
        flex-direction: column;
        align-items: stretch;
        gap: 24px;
        margin-inline: 0;
        padding: 0;
        border-bottom: 0;
        background: none;
    }

    /* Une colonne plus haute que la fenêtre (une grande rubrique ouverte sur un petit écran) ne
       colle pas : son bas resterait hors d'atteinte (static/toc.js) */
    .ks-side--free {
        position: static;
    }

    .ks-side .ks-search,
    .ks-toc {
        flex: none;
        margin-left: 0;
    }

    /* Ouvert à gauche de la page (static/toc.js) : sa ligne « Sommaire » s'en va */
    .ks-toc__contents[open] > summary {
        display: none;
    }
}

/* La recherche : un champ, ses résultats dessous, par-dessus la page */
.ks-search {
    position: relative;
    max-width: 36rem;
    margin: 0 0 28px;
}

.ks-search[hidden] {
    display: none;
}

.ks-search svg {
    position: absolute;
    left: 14px;
    top: 50%;
    width: 20px;
    height: 20px;
    transform: translateY(-50%);
    fill: none;
    stroke: var(--ks-text-light);
    stroke-width: 2;
    stroke-linecap: round;
    pointer-events: none;
}

.ks-search__input {
    width: 100%;
    padding: 12px 16px 12px 44px;
    border: 1px solid color-mix(in oklab, var(--ks-text) 22%, transparent);
    border-radius: 999px;
    background: var(--ks-field-bg, var(--ks-bg));
    color: var(--ks-text);
    font: inherit;
    font-size: 1.05rem;
}

.ks-search__input::placeholder {
    color: var(--ks-text-light);
}

.ks-search__input:focus {
    outline: none;
    border-color: var(--ks-accent);
    box-shadow: 0 0 0 3px color-mix(in oklab, var(--ks-accent) 25%, transparent);
}

.ks-search__results {
    position: absolute;
    top: calc(100% + 6px);
    left: 0;
    z-index: 20;
    width: max(100%, min(28rem, 100vw - 32px));
    max-height: 60vh;
    overflow-y: auto;
    padding: 6px;
    border: 1px solid color-mix(in oklab, var(--ks-text) 16%, transparent);
    border-radius: 14px;
    background: var(--ks-panel-bg, var(--ks-bg));
    box-shadow: 0 16px 40px color-mix(in oklab, var(--ks-header-bg) 22%, transparent);
}

.ks-search__results[hidden] {
    display: none;
}

.ks-search__results a {
    display: block;
    padding: 10px 12px;
    border-radius: 10px;
    color: var(--ks-text);
    text-decoration: none;
}

.ks-search__results a:hover,
.ks-search__results a:focus-visible {
    background: var(--ks-bg-secondary);
    outline: none;
}

.ks-search__results b {
    display: block;
    color: var(--ks-header-bg);
    font-weight: 700;
    line-height: 1.3;
}

/* Où le résultat se trouve (une rubrique, un titre de la page) */
.ks-search__results span {
    display: block;
    margin-top: 2px;
    color: var(--ks-text-light);
    font-size: 0.95rem;
    line-height: 1.35;
}

.ks-search__results p {
    margin: 0;
    padding: 10px 12px;
    color: var(--ks-text-light);
}

/* Dit au lecteur d'écran, pas montré : combien de résultats */
.ks-search__status {
    position: absolute;
    width: 1px;
    height: 1px;
    margin: -1px;
    padding: 0;
    overflow: hidden;
    clip: rect(0 0 0 0);
    white-space: nowrap;
}

/* Le sommaire : les rubriques, leurs pages, celle qu'on lit marquée */
.ks-toc {
    padding-top: 4px;
    font-size: 1.05rem;
}

.ks-toc__home {
    display: inline-block;
    margin-bottom: 18px;
    color: var(--ks-accent);
    font-weight: 700;
    text-underline-offset: 4px;
}

/* Ce qui se plie et se déplie, le sommaire et chacune de ses rubriques : un chevron tourné quand
   c'est ouvert */
.ks-toc summary {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 8px;
    list-style: none;
    cursor: pointer;
}

.ks-toc summary::-webkit-details-marker {
    display: none;
}

.ks-toc summary::after {
    content: "";
    flex: none;
    width: 7px;
    height: 7px;
    border-right: 2px solid currentColor;
    border-bottom: 2px solid currentColor;
    transform: rotate(-45deg);
}

.ks-toc details[open] > summary::after {
    transform: rotate(45deg);
}

/* « Sommaire », la seule ligne du sommaire sur téléphone, à côté de la recherche */
.ks-toc__contents > summary {
    padding: 12px 18px;
    border: 1px solid color-mix(in oklab, var(--ks-text) 18%, transparent);
    border-radius: 999px;
    color: var(--ks-text);
    font-weight: 700;
}

/* Une rubrique : son titre en gras, en minuscules (les majuscules se lisaient mal) ; ses pages
   dessous, en retrait le long d'un trait fin que la page lue marque en couleur */
.ks-toc__part > summary {
    margin: 0 0 8px;
    color: var(--ks-text);
    font-size: 1.05rem;
    font-weight: 700;
    line-height: 1.3;
}

.ks-toc__part > summary:hover {
    color: var(--ks-accent);
}

.ks-toc__part + .ks-toc__part {
    margin-top: 12px;
}

/* Une sous-rubrique : dans sa rubrique, sur le trait de ses pages, un cran plus petite ; ses pages
   un cran plus loin */
.ks-toc__part .ks-toc__part {
    margin: 0 0 0 2px;
    padding: 4px 0 4px 14px;
    border-left: 2px solid color-mix(in oklab, var(--ks-text) 14%, transparent);
}

.ks-toc__part .ks-toc__part + .ks-toc__part {
    margin-top: 0;
}

.ks-toc__part .ks-toc__part > summary {
    margin-bottom: 4px;
    font-size: 1rem;
    font-weight: 600;
}

.ks-toc ul {
    margin: 0 0 8px 2px;
    padding: 0;
    list-style: none;
}

/* Le trait des pages continue sur celui de la sous-rubrique qui suit */
.ks-toc ul:has(+ .ks-toc__part),
.ks-toc__part .ks-toc__part ul {
    margin-bottom: 0;
}

.ks-toc__part .ks-toc__part:last-child {
    margin-bottom: 8px;
}

.ks-toc li {
    padding: 4px 0 4px 14px;
    border-left: 2px solid color-mix(in oklab, var(--ks-text) 14%, transparent);
}

/* La page lue : une bande teintée le long du trait, comme l'élément choisi d'une liste (le trait
   et le gras seuls passaient inaperçus) */
.ks-toc li:has(> a[aria-current="page"]) {
    border-left: 3px solid var(--ks-accent);
    border-radius: 0 8px 8px 0;
    padding-left: 13px;
    background: color-mix(in oklab, var(--ks-accent) 12%, transparent);
}

/* Toute la ligne se touche, pas seulement ses mots (un lien sur deux lignes laissait un vide) */
.ks-toc li a {
    display: block;
    color: var(--ks-text-light);
    text-decoration: none;
    line-height: 1.35;
}

.ks-toc li a:hover {
    color: var(--ks-text);
    text-decoration: underline;
    text-underline-offset: 4px;
}

.ks-toc a[aria-current="page"] {
    color: var(--ks-text);
    font-weight: 700;
}
