/* ==========================================================
   docs.css — documentation multi-pages
   ----------------------------------------------------------
   Rail de gauche facon Visual Studio Code : une echelle
   verticale, un point lumineux qui glisse jusqu'a l'entree
   courante, et des groupes repliables.
   ========================================================== */

:root { --doc-rail: 292px; --doc-toc: 208px; --doc-top: 64px; }

.doc-shell {
  max-width: 1520px; margin: 0 auto;
  display: grid;
  grid-template-columns: var(--doc-rail) minmax(0, 1fr) var(--doc-toc);
  padding-top: var(--doc-top);
}

/* ---------- le rail ---------- */
.doc-rail {
  position: sticky; top: var(--doc-top); align-self: start;
  height: calc(100vh - var(--doc-top));
  overflow-y: auto;
  padding: 26px 14px 80px 22px;
  border-right: 1px solid var(--line);
  scrollbar-width: thin;
}
.doc-rail::-webkit-scrollbar { width: 8px; }
.doc-rail::-webkit-scrollbar-thumb { background: var(--line-2); border-radius: 99px; }

.doc-rail-search {
  display: flex; align-items: center; gap: 8px;
  padding: 7px 10px; margin-bottom: 18px;
  border: 1px solid var(--line); border-radius: var(--r-sm);
  background: var(--bg-card);
  font-family: var(--mono); font-size: 12px; color: var(--ink-3);
}
.doc-rail-search input {
  border: 0; outline: 0; background: none; width: 100%;
  font-family: var(--mono); font-size: 12px; color: var(--ink);
}
.doc-rail-search svg { width: 13px; height: 13px; flex: none; }

/* la piste verticale + le point lumineux */
.doc-rail-inner { position: relative; padding-left: 16px; }
.doc-rail-track {
  position: absolute; left: 3px; top: 0; bottom: 0; width: 2px;
  background: var(--line); border-radius: 2px;
}
.doc-rail-dot {
  position: absolute; left: -1px; width: 8px; height: 8px;
  border-radius: 50%; background: var(--blue);
  box-shadow: 0 0 0 3px rgba(29,78,216,.16), 0 0 12px 2px rgba(29,78,216,.55);
  transition: top .34s cubic-bezier(.22,.61,.36,1), opacity .2s;
  opacity: 0; pointer-events: none;
}
.doc-rail-dot.on { opacity: 1; }

/* ---------- groupes repliables ---------- */
.doc-group { margin-bottom: 6px; }
.doc-group-head {
  display: flex; align-items: center; gap: 7px; width: 100%;
  padding: 6px 8px; border-radius: var(--r-xs);
  font-family: var(--mono); font-size: 10.5px; letter-spacing: .13em;
  text-transform: uppercase; color: var(--ink-4);
  cursor: pointer; user-select: none; text-align: left;
  transition: background .15s, color .15s;
}
.doc-group-head:hover { background: var(--bg-soft); color: var(--ink-2); }
.doc-group-head .chev {
  width: 10px; height: 10px; flex: none;
  transition: transform .28s cubic-bezier(.22,.61,.36,1);
}
.doc-group.collapsed .chev { transform: rotate(-90deg); }
.doc-group-body {
  overflow: hidden;
  max-height: 1400px;
  transition: max-height .34s cubic-bezier(.22,.61,.36,1), opacity .2s;
}
.doc-group.collapsed .doc-group-body { max-height: 0; opacity: 0; }

.doc-rail a {
  display: flex; align-items: center; gap: 8px;
  padding: 5px 10px; margin: 1px 0;
  border-radius: var(--r-xs);
  font-size: 13.4px; line-height: 1.35; color: var(--ink-2);
  text-decoration: none;
  transition: background .13s, color .13s;
}
.doc-rail a:hover { background: var(--bg-soft); color: var(--ink); }
.doc-rail a.active { background: rgba(29,78,216,.07); color: var(--blue); font-weight: 500; }
.doc-rail a .k {
  font-family: var(--mono); font-size: 9.5px; color: var(--ink-4);
  margin-left: auto; flex: none;
}

/* ---------- la page ---------- */
.doc-main { padding: 34px 52px 120px; min-width: 0; }
.doc-crumbs {
  font-family: var(--mono); font-size: 11px; letter-spacing: .08em;
  text-transform: uppercase; color: var(--ink-4); margin-bottom: 14px;
}
.doc-crumbs a { color: var(--ink-3); text-decoration: none; }
.doc-crumbs a:hover { color: var(--blue); }
.doc-main h1 { font-size: clamp(30px, 3.4vw, 42px); margin-bottom: 12px; letter-spacing: -0.025em; }
.doc-lede { font-size: 17px; color: var(--ink-2); line-height: 1.6; max-width: 68ch; margin-bottom: 34px; }
.doc-main h2 { font-size: 26px; margin: 44px 0 14px; letter-spacing: -0.02em; }
.doc-main h3 { font-size: 19px; margin: 30px 0 10px; }
.doc-main p, .doc-main li { max-width: 74ch; line-height: 1.68; color: var(--ink-2); }
.doc-main p { margin-bottom: 14px; }
.doc-main ul, .doc-main ol { margin: 0 0 16px 20px; }
.doc-main li { margin-bottom: 6px; }
.doc-main code { font-family: var(--mono); font-size: .88em; background: var(--bg-soft); padding: 1px 5px; border-radius: 4px; }
.doc-main table { margin-bottom: 22px; }

/* pagination bas de page */
.doc-pager {
  display: grid; grid-template-columns: 1fr 1fr; gap: 14px;
  margin-top: 64px; padding-top: 26px; border-top: 1px solid var(--line);
}
.doc-pager a {
  display: block; padding: 14px 18px;
  border: 1px solid var(--line); border-radius: var(--r-md);
  text-decoration: none; background: var(--bg-card);
  transition: border-color .15s, transform .15s;
}
.doc-pager a:hover { border-color: var(--blue); transform: translateY(-1px); }
.doc-pager .dir { font-family: var(--mono); font-size: 10px; letter-spacing: .14em; text-transform: uppercase; color: var(--ink-4); }
.doc-pager .ttl { font-size: 15px; color: var(--ink); margin-top: 4px; font-weight: 500; }
.doc-pager .next { text-align: right; }

/* ---------- sommaire de droite ---------- */
.doc-toc {
  position: sticky; top: var(--doc-top); align-self: start;
  height: calc(100vh - var(--doc-top)); overflow-y: auto;
  padding: 34px 22px 60px 8px;
}
.doc-toc h5 {
  font-family: var(--mono); font-size: 10px; letter-spacing: .14em;
  text-transform: uppercase; color: var(--ink-4); margin-bottom: 12px;
}
.doc-toc a {
  display: block; padding: 4px 0 4px 12px;
  border-left: 2px solid var(--line);
  font-size: 12.6px; color: var(--ink-3); text-decoration: none;
}
.doc-toc a:hover { color: var(--ink); }
.doc-toc a.active { color: var(--blue); border-left-color: var(--blue); }

@media (max-width: 1240px) { .doc-toc { display: none; } .doc-shell { grid-template-columns: var(--doc-rail) minmax(0,1fr); } }
@media (max-width: 980px) {
  .doc-shell { grid-template-columns: 1fr; }
  .doc-rail { position: static; height: auto; border-right: 0; border-bottom: 1px solid var(--line); }
  .doc-main { padding: 26px 20px 80px; }
}
@media (prefers-reduced-motion: reduce) { .doc-rail-dot, .doc-group-body, .chev { transition: none; } }

/* ---------- accueil de la doc ---------- */
.doc-hub { display: grid; grid-template-columns: repeat(auto-fit, minmax(230px, 1fr)); gap: 18px; margin-top: 34px; }
.doc-hub-group {
  border: 1px solid var(--line); border-radius: var(--r-md);
  background: var(--bg-card); padding: 20px 22px;
}
.doc-hub-group h2 {
  font-size: 13px !important; margin: 0 0 12px !important;
  font-family: var(--mono); letter-spacing: .13em; text-transform: uppercase;
  color: var(--ink-4); font-weight: 400;
}
.doc-hub-group ul { list-style: none; margin: 0; }
.doc-hub-group li { margin-bottom: 7px; }
.doc-hub-group a { color: var(--ink); text-decoration: none; font-size: 14.5px; }
.doc-hub-group a:hover { color: var(--blue); }

/* ==========================================================
   Sélecteurs de version et de langue
   ========================================================== */
.doc-switchers { display: flex; gap: 6px; margin-bottom: 14px; }
.doc-switch {
  flex: 1; min-width: 0; padding: 6px 8px;
  border: 1px solid var(--line); border-radius: var(--r-xs);
  background: var(--bg-card); color: var(--ink);
  font-family: var(--mono); font-size: 11.5px; cursor: pointer;
}
.doc-switch:hover { border-color: var(--blue); }

/* ---------- résultats de recherche ---------- */
.doc-results {
  border: 1px solid var(--line); border-radius: var(--r-xs);
  background: var(--bg-card); margin-bottom: 14px;
  max-height: 340px; overflow-y: auto;
}
.doc-result {
  display: block; padding: 9px 11px; border-bottom: 1px solid var(--line);
  text-decoration: none; color: var(--ink);
}
.doc-result:last-child { border-bottom: 0; }
.doc-result:hover, .doc-result.sel { background: rgba(29,78,216,.06); }
.doc-result .t { font-size: 13.5px; font-weight: 500; }
.doc-result .g { font-family: var(--mono); font-size: 10px; color: var(--ink-4); letter-spacing: .1em; text-transform: uppercase; }
.doc-result .s { font-size: 12px; color: var(--ink-3); margin-top: 3px; line-height: 1.45;
  display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; }
.doc-result mark { background: rgba(29,78,216,.18); color: inherit; padding: 0 1px; }
.doc-results-empty { padding: 16px; text-align: center; color: var(--ink-3); font-size: 13px; }

/* ---------- bouton copier ---------- */
.code-block, .code { position: relative; }
.code-copy {
  position: absolute; top: 7px; right: 8px;
  font-family: var(--mono); font-size: 10.5px; letter-spacing: .06em;
  padding: 3px 8px; border-radius: var(--r-xs);
  border: 1px solid rgba(255,255,255,.16); background: rgba(255,255,255,.06);
  color: #cfccc4; cursor: pointer; opacity: 0; transition: opacity .15s, background .15s;
}
.code-block:hover .code-copy, .code:hover .code-copy, .code-copy:focus { opacity: 1; }
.code-copy:hover { background: rgba(255,255,255,.14); color: #fff; }
.code-copy.done { color: #7fce7a; border-color: rgba(127,206,122,.4); }

/* ---------- pied de page d'article ---------- */
.doc-foot {
  display: flex; gap: 10px; flex-wrap: wrap;
  margin-top: 34px; padding-top: 18px; border-top: 1px solid var(--line);
}
.doc-tool {
  font-family: var(--mono); font-size: 11.5px;
  padding: 6px 11px; border: 1px solid var(--line); border-radius: var(--r-xs);
  background: var(--bg-card); color: var(--ink-2); cursor: pointer; text-decoration: none;
}
.doc-tool:hover { border-color: var(--blue); color: var(--blue); }
.doc-toc-tools { margin-top: 18px; padding-top: 14px; border-top: 1px solid var(--line); }

/* ---------- glossaire au survol ---------- */
.gloss {
  border-bottom: 1px dotted var(--ink-4);
  cursor: help; position: relative;
}
.gloss:hover { border-bottom-color: var(--blue); }
.gloss-pop {
  position: fixed; z-index: 300; max-width: 320px;
  background: var(--ink); color: #ecebe6;
  border-radius: var(--r-xs); padding: 10px 13px;
  font-size: 12.5px; line-height: 1.55; font-family: var(--sans);
  box-shadow: 0 6px 24px rgba(0,0,0,.22); pointer-events: none;
}
.gloss-pop b { display: block; color: #fff; margin-bottom: 4px; font-size: 13px; }

/* ---------- tutoriels ---------- */
.tut-step {
  border: 1px solid var(--line); border-radius: var(--r-md);
  background: var(--bg-card); padding: 18px 20px 18px 52px;
  margin-bottom: 12px; position: relative; transition: border-color .18s, background .18s;
}
.tut-step::before {
  content: attr(data-n); position: absolute; left: 16px; top: 18px;
  width: 24px; height: 24px; border-radius: 50%;
  border: 1px solid var(--line-2); background: var(--bg);
  display: grid; place-items: center;
  font-family: var(--mono); font-size: 11px; color: var(--ink-3);
}
.tut-step h3 { font-size: 16px !important; margin: 0 0 8px !important; }
.tut-step p { margin-bottom: 8px; font-size: 14px; }
.tut-step.done { background: rgba(46,125,50,.04); border-color: rgba(46,125,50,.25); }
.tut-step.done::before { content: "✓"; background: #2e7d32; border-color: #2e7d32; color: #fff; }
.tut-step.done h3 { color: var(--ink-3); }
.tut-check {
  margin-top: 10px; font-family: var(--mono); font-size: 11.5px;
  padding: 5px 11px; border: 1px solid var(--line-2); border-radius: var(--r-xs);
  background: var(--bg); color: var(--ink-2); cursor: pointer;
}
.tut-check:hover { border-color: var(--blue); color: var(--blue); }
.tut-progress {
  display: flex; align-items: center; gap: 12px;
  padding: 12px 16px; margin-bottom: 18px;
  border: 1px solid var(--line); border-radius: var(--r-md); background: var(--bg-soft);
  font-family: var(--mono); font-size: 12.5px; color: var(--ink-2);
}
.tut-bar { flex: 1; height: 5px; border-radius: 3px; background: var(--line); overflow: hidden; }
.tut-bar i { display: block; height: 100%; background: var(--blue); transition: width .3s; }

/* ---------- niveaux d'erreur ---------- */
.err-sev {
  font-family: var(--mono); font-size: 10px; letter-spacing: .1em;
  text-transform: uppercase; padding: 2px 7px; border-radius: 3px;
}
.err-sev.error   { color: #a3341f; background: #fdf3f1; border: 1px solid #e8c4be; }
.err-sev.warning { color: #7a5c14; background: rgba(217,155,30,.10); border: 1px solid rgba(217,155,30,.4); }
.err-sev.info    { color: var(--ink-3); background: var(--bg-soft); border: 1px solid var(--line); }

kbd {
  font-family: var(--mono); font-size: 11.5px;
  padding: 2px 7px; border: 1px solid var(--line-2); border-bottom-width: 2px;
  border-radius: var(--r-xs); background: var(--bg-card); color: var(--ink);
  white-space: nowrap;
}

/* ---------- impression / PDF ---------- */
@media print {
  .beta-bar, nav.topnav, .doc-rail, .doc-toc, .doc-pager, .doc-foot,
  .site-footer, [data-thread], .statusbar { display: none !important; }
  .doc-shell { grid-template-columns: 1fr; padding-top: 0; }
  .doc-main { padding: 0; }
  body { padding: 0; background: #fff; }
  a { color: #000; text-decoration: underline; }
  a[href^="/"]::after { content: " (eeg.studio" attr(href) ")"; font-size: 10px; color: #555; }
  .code-block, .code, pre { border: 1px solid #ccc !important; background: #f6f6f6 !important; color: #111 !important; }
  .code-body, .code-body span { color: #111 !important; }
  table, .spec { page-break-inside: avoid; }
  h1, h2, h3 { page-break-after: avoid; }
}