/* Documentação — casca de três faixas (marca, menu, artigo).
   Vale para /documentacao e para toda página de /documentacao/<slug>.
   Depende dos tokens de upinion.css: nada de cor solta aqui.

   O layout é o de um site de documentação: o menu lateral fica parado enquanto o artigo
   rola, e o tópico aberto mostra os subtópicos dele no próprio menu. Quem lê nunca perde
   o mapa de onde está.
   A casca inteira é injetada por docs.js — cada artigo no repositório é só a prosa. */

body.docs {
  background: var(--bg);
  margin: 0;

  /* O menu encosta na borda esquerda da janela, como em qualquer site de documentação —
     por isso a grade não tem teto. Quem segura o texto é a medida da coluna de leitura,
     abaixo; o vazio que sobra à direita em monitor largo é onde a grade respira mais
     (ver o @media de 1700px no fim do arquivo). */
  --docs-gutter: 28px;
  --docs-menu: 272px;
  --docs-gap: 56px;
  /* Em px, e não em ch: `ch` depende da fonte do elemento, e a do artigo é herdada — a
     medida saía 130px menor do que a conta prometia. */
  --docs-medida: 960px;
}

/* ---------- faixa da marca ---------- */

.docs-top {
  background: var(--bg);
  border-bottom: 1px solid var(--line);
  position: sticky;
  top: 0;
  z-index: var(--z-sticky);
}
/* A faixa e a grade compartilham o respiro lateral: é o que mantém a marca alinhada com o
   menu, na coluna da esquerda. */
.docs-top-in {
  margin: 0 auto;
  padding: 0 var(--docs-gutter);
  height: 56px;
  display: flex;
  align-items: center;
  gap: 16px;
}
.docs-brand {
  display: inline-flex;
  align-items: center;
  gap: 9px;
  color: var(--ink);
  font-weight: 800;
  font-size: var(--t-md);
  letter-spacing: -0.01em;
  white-space: nowrap;
}
.docs-brand:hover { text-decoration: none; }
.docs-brand img { width: 22px; height: 22px; display: block; }
.docs-brand .docs-brand-sep { color: var(--line-2); font-weight: 400; }
.docs-brand .docs-brand-tag { color: var(--muted); font-weight: 600; }
.docs-top-right {
  margin-left: auto;
  display: flex;
  align-items: center;
  gap: 18px;
  font-size: var(--t-sm);
}
.docs-top-right a { white-space: nowrap; }

/* botão do menu — só existe em tela estreita */
.docs-burger {
  display: none;
  align-items: center;
  gap: 8px;
  background: none;
  border: 1px solid var(--line);
  border-radius: var(--r-2);
  color: var(--ink);
  font: inherit;
  font-size: var(--t-sm);
  font-weight: 600;
  padding: 6px 11px;
  cursor: pointer;
}
.docs-burger:hover { background: var(--surface-2); }
.docs-burger span {
  display: block;
  width: 14px;
  height: 9px;
  border-top: 2px solid currentColor;
  border-bottom: 2px solid currentColor;
}

/* ---------- grade ---------- */

.docs-grid {
  margin: 0 auto;
  padding: 0 var(--docs-gutter);
  display: grid;
  grid-template-columns: var(--docs-menu) minmax(0, 1fr);
  gap: var(--docs-gap);
  align-items: start;
}

/* ---------- menu lateral ---------- */

.docs-side {
  position: sticky;
  top: 56px;
  max-height: calc(100vh - 56px);
  overflow-y: auto;
  padding: 26px var(--docs-gutter) 48px 0;
  border-right: 1px solid var(--line);
  margin-right: calc(var(--docs-gutter) * -1);
}
.docs-search { margin: 0 0 20px; }
.docs-search input {
  width: 100%;
  box-sizing: border-box;
  padding: 8px 11px;
  border: 1px solid var(--line);
  border-radius: var(--r-2);
  background: var(--surface-2);
  color: var(--ink);
  font: inherit;
  font-size: var(--t-sm);
}
.docs-search input:focus {
  outline: 2px solid var(--primary-border);
  border-color: var(--primary-border);
  background: var(--bg);
}
.docs-nav-empty {
  display: none;
  color: var(--muted);
  font-size: var(--t-sm);
  padding: 4px 2px 12px;
}

.docs-group { margin: 0 0 22px; }
.docs-group > h2 {
  font-size: var(--t-xs);
  text-transform: uppercase;
  letter-spacing: 0.07em;
  color: var(--faint);
  font-weight: 700;
  margin: 0 0 7px;
  padding: 0 10px;
}
.docs-group ul { list-style: none; margin: 0; padding: 0; }

.docs-group a {
  display: block;
  padding: 6px 10px;
  border-radius: var(--r-2);
  color: var(--muted);
  font-size: var(--t-base);
  line-height: 1.4;
  font-weight: 500;
  text-decoration: none;
}
.docs-group a:hover { background: var(--surface-2); color: var(--ink); text-decoration: none; }
.docs-group a.is-current {
  background: var(--primary-soft);
  color: var(--primary-strong);
  font-weight: 700;
}

/* subtópicos do artigo aberto: as seções da própria página */
.docs-sub {
  list-style: none;
  margin: 3px 0 8px;
  padding: 0 0 0 10px;
  border-left: 1px solid var(--line-2);
  margin-left: 11px;
}
.docs-sub a {
  padding: 4px 9px;
  font-size: var(--t-sm);
  font-weight: 500;
  color: var(--muted);
}
.docs-sub a.is-inview {
  color: var(--primary-strong);
  font-weight: 700;
  background: var(--surface-2);
}
.docs-sub .docs-sub-h3 a { padding-left: 20px; font-size: var(--t-xs); }

/* ---------- artigo ---------- */

.docs-main { padding: 34px 0 96px; min-width: 0; }
/* A medida da coluna de texto: 960px com o corpo em 16px. Mais larga que os 754px de antes,
   e ainda uma linha que o olho reencontra ao voltar — daí o teto existir. */
.doc { max-width: var(--docs-medida); }

.doc-kicker {
  font-size: var(--t-xs);
  text-transform: uppercase;
  letter-spacing: 0.07em;
  color: var(--primary-strong);
  font-weight: 700;
  margin: 0 0 8px;
}
.doc h1 {
  font-size: var(--t-3xl);
  letter-spacing: -0.02em;
  margin: 0 0 10px;
}
.doc-lede {
  font-size: var(--t-lg);
  line-height: 1.55;
  color: var(--muted);
  margin: 0 0 12px;
}
.doc-stamp {
  font-size: var(--t-xs);
  color: var(--faint);
  margin: 0 0 30px;
}

.doc h2 {
  font-size: var(--t-xl);
  letter-spacing: -0.01em;
  margin: 40px 0 12px;
  padding-top: 20px;
  border-top: 1px solid var(--line);
  scroll-margin-top: 76px;
}
.doc h3 {
  font-size: var(--t-md);
  margin: 26px 0 8px;
  scroll-margin-top: 76px;
}
.doc p, .doc li { font-size: 16px; line-height: 1.7; color: var(--ink); }
.doc p { margin: 0 0 14px; }
.doc ul, .doc ol { margin: 0 0 16px; padding-left: 22px; }
.doc li { margin-bottom: 7px; }
.doc li > ul, .doc li > ol { margin: 7px 0 0; }
.doc a { color: var(--primary-strong); }
.doc strong { font-weight: 700; }

.doc code {
  font-family: var(--font-mono);
  font-size: 0.9em;
  background: var(--surface-2);
  border: 1px solid var(--line);
  border-radius: 4px;
  padding: 1px 5px;
  overflow-wrap: anywhere;
}
.doc pre {
  background: var(--surface-2);
  border: 1px solid var(--line);
  border-radius: var(--r-2);
  padding: 14px 16px;
  overflow-x: auto;
  margin: 0 0 16px;
}
.doc pre code { background: none; border: 0; padding: 0; font-size: var(--t-sm); line-height: 1.6; }

/* captura de tela — a moldura e a legenda deixam claro que ali é a tela, e não desenho
   nosso. A imagem nunca passa da medida do texto: uma captura de 1068 px estourando a
   coluna faz a pessoa rolar de lado para ler o artigo. */
.doc figure { margin: 0 0 18px; }
.doc figure img {
  display: block;
  /* teto em 560 px porque a captura é gravada em 2x (retina): esticá-la até a medida do
     texto a mostraria maior do que ela é na tela, e o leitor compara o que vê aqui com o
     que tem aberto no construtor */
  max-width: min(100%, 560px);
  height: auto;
  border: 1px solid var(--line);
  border-radius: var(--r-2);
  background: var(--bg);
}
.doc figcaption {
  margin-top: 7px;
  font-size: var(--t-sm);
  line-height: 1.5;
  color: var(--muted);
}

/* passos numerados — a norma dos documentos: uma instrução por item */
.doc ol.doc-steps { counter-reset: step; list-style: none; padding-left: 0; }
.doc ol.doc-steps > li {
  counter-increment: step;
  position: relative;
  padding-left: 34px;
  margin-bottom: 11px;
}
.doc ol.doc-steps > li::before {
  content: counter(step);
  position: absolute;
  left: 0;
  top: 1px;
  width: 22px;
  height: 22px;
  border-radius: var(--r-pill);
  background: var(--primary-soft);
  color: var(--primary-strong);
  border: 1px solid var(--primary-border);
  font-size: var(--t-xs);
  font-weight: 800;
  display: grid;
  place-items: center;
}

/* caixas de aviso */
.doc-note, .doc-warn {
  border: 1px solid var(--primary-border);
  background: var(--primary-soft);
  border-radius: var(--r-2);
  padding: 13px 16px;
  margin: 0 0 18px;
}
.doc-warn { border-color: var(--warning); background: var(--warning-soft); }
.doc-note > :last-child, .doc-warn > :last-child { margin-bottom: 0; }
.doc-note p, .doc-warn p { font-size: var(--t-sm); }
.doc-note b, .doc-warn b { display: block; margin-bottom: 3px; }

/* tabelas */
.doc-table { overflow-x: auto; margin: 0 0 18px; }
.doc table {
  border-collapse: collapse;
  width: 100%;
  font-size: var(--t-sm);
  border: 1px solid var(--line);
  border-radius: var(--r-2);
}
.doc th, .doc td {
  text-align: left;
  padding: 9px 12px;
  border-bottom: 1px solid var(--line);
  vertical-align: top;
  line-height: 1.55;
}
.doc th { background: var(--surface-2); font-weight: 700; color: var(--ink); white-space: nowrap; }
.doc tr:last-child td { border-bottom: 0; }

/* cartões do índice */
/* 190px: é o mínimo que ainda deixa os três atalhos numa linha só na medida do artigo.
   Com 240 o terceiro caía sozinho na segunda linha, ao lado de um vazio. */
.docs-cards {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(190px, 1fr));
  gap: 14px;
  margin: 0 0 34px;
}
.docs-card {
  display: block;
  border: 1px solid var(--line);
  border-radius: var(--r-3);
  padding: 16px 18px;
  background: var(--bg);
  box-shadow: var(--shadow-sm);
  text-decoration: none;
}
.docs-card:hover { border-color: var(--primary-border); text-decoration: none; box-shadow: var(--shadow-md); }
.docs-card b { display: block; color: var(--ink); font-size: var(--t-md); margin-bottom: 4px; }
.docs-card span { display: block; color: var(--muted); font-size: var(--t-sm); line-height: 1.5; }

.docs-index-group { margin: 0 0 30px; }
.docs-index-group h2 {
  font-size: var(--t-lg);
  margin: 0 0 4px;
  padding-top: 20px;
  border-top: 1px solid var(--line);
}
.docs-index-group > p { color: var(--muted); font-size: var(--t-sm); margin: 0 0 14px; }
.docs-index-list { list-style: none; margin: 0; padding: 0; }
.docs-index-list li { margin: 0 0 3px; }
.docs-index-list a { font-size: var(--t-md); font-weight: 600; }
.docs-index-list span { color: var(--muted); font-size: var(--t-sm); font-weight: 400; }

/* ---------- pé: anterior e próximo ---------- */

.docs-pager {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 14px;
  margin: 52px 0 0;
  padding-top: 24px;
  border-top: 1px solid var(--line);
  max-width: var(--docs-medida);
}
.docs-pager a {
  border: 1px solid var(--line);
  border-radius: var(--r-3);
  padding: 13px 16px;
  text-decoration: none;
  background: var(--bg);
}
.docs-pager a:hover { border-color: var(--primary-border); text-decoration: none; }
.docs-pager small { display: block; color: var(--faint); font-size: var(--t-xs); margin-bottom: 3px; }
.docs-pager b { color: var(--ink); font-size: var(--t-base); font-weight: 700; }
.docs-pager .docs-pager-next { text-align: right; grid-column: 2; }

.docs-foot {
  max-width: var(--docs-medida);
  margin: 34px 0 0;
  color: var(--faint);
  font-size: var(--t-xs);
  line-height: 1.6;
}

/* ---------- tela estreita ---------- */

/* Monitor largo: em vez de deixar todo o excedente num vazio à direita, a grade toda
   respira mais — o menu se afasta um pouco da borda e a coluna de leitura cresce. */
@media (min-width: 1700px) {
  body.docs { --docs-gutter: 72px; --docs-gap: 88px; --docs-medida: 1080px; }
}

@media (max-width: 900px) {
  .docs-grid { grid-template-columns: minmax(0, 1fr); gap: 0; padding: 0 18px; }
  .docs-burger { display: inline-flex; }
  .docs-top-in { padding: 0 14px; gap: 12px; }
  .docs-top-right { gap: 14px; }
  /* o atalho para a ajuda continua no pé do artigo: aqui ele só empurrava a marca para fora */
  .docs-top-ajuda { display: none; }
  .docs-side {
    position: fixed;
    inset: 56px auto 0 0;
    width: 292px;
    max-width: 84vw;
    background: var(--bg);
    border-right: 1px solid var(--line);
    box-shadow: var(--shadow-lg);
    padding: 20px 18px 40px;
    margin: 0;
    transform: translateX(-102%);
    transition: transform 0.18s ease;
    z-index: var(--z-modal);
  }
  body.docs-side-open .docs-side { transform: none; }
  .docs-scrim {
    display: none;
    position: fixed;
    inset: 56px 0 0;
    background: oklch(0.24 0.02 264 / 0.34);
    z-index: var(--z-backdrop);
  }
  body.docs-side-open .docs-scrim { display: block; }
  .docs-main { padding: 24px 0 72px; }
  .doc h1 { font-size: var(--t-2xl); }
  .doc-lede { font-size: var(--t-md); }
  .docs-pager { grid-template-columns: 1fr; }
  .docs-pager .docs-pager-next { text-align: left; grid-column: 1; }
  /* marcada por docs.js: tabela de 3+ colunas rola em vez de comprimir as células */
  .doc-table.is-larga table { min-width: 30rem; }
  .doc-table.is-larga { box-shadow: inset -14px 0 12px -12px oklch(0.24 0.02 264 / 0.16); }
  /* a captura segue a mesma regra da tabela larga: rola de lado em vez de encolher. Numa
     tela de 390 px ela cabia inteira, e o texto DENTRO dela ficava ilegível — uma imagem
     que ninguém consegue ler não ilustra nada. */
  .doc figure { overflow-x: auto; box-shadow: inset -14px 0 12px -12px oklch(0.24 0.02 264 / 0.16); }
  .doc figure img { max-width: none; width: 33rem; }
  .doc figcaption { position: sticky; left: 0; }
}

@media (max-width: 430px) {
  .docs-brand .docs-brand-sep, .docs-brand .docs-brand-tag { display: none; }
}

@media (prefers-reduced-motion: reduce) {
  .docs-side { transition: none; }
}