/* ===========================================================================
   AJUDA CONTEXTUAL (ⓘ) — painel do guia da tela
   Spec: docs/superpowers/specs/2026-10-05-ajuda-contextual-design.md

   Desktop (>= 992px): painel lateral DIREITO, NAO-MODAL. Sem fundo escuro e
   sem prender o foco: o gestor le o passo e executa na tela ao lado. Por isso
   a partir de 1200px a .app-main encolhe a largura do painel — nada da tela
   fica por baixo dele. Entre 992 e 1199 o painel sobrepoe (nao cabem os dois).

   Celular (< 992px): folha que sobe de baixo, altura total, com fundo.

   z-index 1045: ACIMA do cabecalho (1020) e da sidebar (1030), ABAIXO do
   modal do Bootstrap (1050/1055) e do SweetAlert (1060). Um "Confirmar"
   aberto com o guia na tela precisa ficar por cima dele. (A folha generica
   .sheet-cf fica em 1400, acima dos modais — por isso este painel e um
   componente proprio, e nao ela.)
   =========================================================================== */

:root { --ajuda-largura: 420px; }

/* ---------- Botao do topo ---------- */
.ajuda-btn-topo[hidden] { display: none !important; }
.ajuda-btn-topo[aria-expanded="true"] {
  background: var(--color-primary-soft);
  color: var(--color-primary);
}

/* ---------- ⓘ de secao (ao lado do titulo) ---------- */
.ajuda-ancora {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 28px;
  height: 28px;
  margin-left: var(--space-2);
  padding: 0;
  border: 0;
  border-radius: var(--radius-full);
  background: transparent;
  color: var(--text-muted);
  font-size: 0.95rem;
  line-height: 1;
  vertical-align: middle;
  cursor: pointer;
  transition: background var(--dur-fast) var(--ease-out), color var(--dur-fast) var(--ease-out);
  flex-shrink: 0;
}
.ajuda-ancora:hover { background: var(--color-primary-soft); color: var(--color-primary); }
/* Alvo de toque de 44px no aparelho de toque, sem mudar o desenho: a area
   clicavel cresce por pseudo-elemento (regra canonica em buttons.css). */
@media (hover: none) and (pointer: coarse) {
  .ajuda-ancora { position: relative; }
  .ajuda-ancora::after { content: ''; position: absolute; inset: -8px; }
}

/* ---------- Painel ---------- */
.ajuda-painel {
  position: fixed;
  z-index: 1045;
  display: flex;
  flex-direction: column;
  background: var(--bg-surface);
  color: var(--text-primary);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  visibility: hidden;
  transition: transform var(--dur-base) var(--ease-out), visibility 0s linear var(--dur-base);
}
.ajuda-painel.is-aberto {
  visibility: visible;
  transition: transform var(--dur-base) var(--ease-out), visibility 0s;
}

/* Aberto por um ⓘ DENTRO de um popup/modal (ajudaPainel.js): acima do
   SweetAlert (1060), senao o guia abriria escondido atras de quem o chamou.
   O clique no painel nao chega ao fundo do popup, entao ele nao fecha. */
.ajuda-painel.is-sobre-overlay { z-index: 1071; }
.ajuda-fundo.is-sobre-overlay { z-index: 1070; }
/* ...e o popup de baixo se recentra no espaco que sobra a esquerda. Sem isto
   ele seguia centrado na TELA e o painel cobria a parte direita dele — os
   botoes "Adicionar" e a lixeira da variante, justamente o que o guia de
   estoque explica (visto na foto; o teste de "esta na frente" passava). */
@media (min-width: 992px) {
  body.ajuda-sobre-overlay .swal2-container,
  body.ajuda-sobre-overlay .modal { padding-right: var(--ajuda-largura) !important; }
}

.ajuda-fundo {
  position: fixed;
  inset: 0;
  z-index: 1044;
  background: color-mix(in srgb, var(--neutral-950, #0a0c0b) 45%, transparent);
  opacity: 0;
  pointer-events: none;
  transition: opacity var(--dur-base) var(--ease-out);
}

@media (min-width: 992px) {
  .ajuda-painel {
    top: 0;
    right: 0;
    bottom: 0;
    width: min(var(--ajuda-largura), 100vw);
    border-left: 1px solid var(--border-color);
    box-shadow: var(--shadow-float);
    transform: translateX(100%);
  }
  .ajuda-painel.is-aberto { transform: translateX(0); }
  /* Nao-modal: o fundo nao existe no desktop. */
  .ajuda-fundo { display: none; }
}
@media (min-width: 1200px) {
  .app-shell.ajuda-aberta .app-main {
    margin-right: var(--ajuda-largura);
    transition: margin-left var(--transition-base), margin-right var(--dur-base) var(--ease-out);
  }
  /* A pagina encolhida fica com a largura de uma tela menor, e o cabecalho
     estrangulava: a busca virava um balao alto com o texto quebrado em quatro
     linhas e o titulo "Pagamento au..." (visto na FOTO — nenhuma medida pegou).
     A busca assume a mesma forma compacta (so a lupa) que ja tem abaixo de
     991px (overlays.css), e o titulo ganha o espaco. */
  .app-shell.ajuda-aberta .cmdk-trigger__text,
  .app-shell.ajuda-aberta .cmdk-trigger kbd { display: none; }
  .app-shell.ajuda-aberta .cmdk-trigger {
    flex: 0 0 auto;
    max-width: none;
    min-width: 40px;
    justify-content: center;
    padding: 0.55rem;
  }
}

@media (max-width: 991.98px) {
  .ajuda-painel {
    left: 0;
    right: 0;
    bottom: 0;
    /* vh antes: navegador sem dvh (iOS < 15.4) descarta a declaracao seguinte
       inteira e ficaria sem altura nenhuma. */
    height: calc(100vh - 12px);
    height: calc(100dvh - env(safe-area-inset-top, 0px) - 12px);
    border-top-left-radius: var(--radius-panel);
    border-top-right-radius: var(--radius-panel);
    box-shadow: var(--shadow-xl);
    transform: translateY(100%);
  }
  .ajuda-painel.is-aberto { transform: translateY(0); }
  .ajuda-fundo.is-aberto { opacity: 1; pointer-events: auto; }
}

.ajuda-painel__alca {
  display: none;
  width: 40px;
  height: 4px;
  margin: var(--space-3) auto 0;
  border-radius: var(--radius-full);
  background: var(--border-input, var(--border-color));
  flex-shrink: 0;
  cursor: grab;
}
@media (max-width: 991.98px) { .ajuda-painel__alca { display: block; } }

.ajuda-painel__topo {
  display: flex;
  align-items: flex-start;
  gap: var(--space-3);
  padding: var(--space-5) var(--space-5) var(--space-4);
  border-bottom: 1px solid var(--border-color);
  flex-shrink: 0;
}
.ajuda-painel__icone {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 40px;
  height: 40px;
  border-radius: var(--radius-full);
  background: var(--color-primary-soft);
  color: var(--color-primary);
  flex-shrink: 0;
}
.ajuda-painel__cabeca { flex: 1; min-width: 0; }
.ajuda-painel__rotulo {
  margin: 0 0 2px;
  font-size: var(--text-xs);
  font-weight: var(--fw-semibold);
  color: var(--text-muted);
  letter-spacing: 0.02em;
}
.ajuda-painel__titulo {
  margin: 0;
  font-size: var(--text-lg);
  font-weight: var(--fw-bold);
  line-height: var(--leading-tight);
  letter-spacing: -0.01em;
}
.ajuda-painel__resumo {
  margin: var(--space-2) 0 0;
  font-size: var(--text-sm);
  color: var(--text-secondary);
  line-height: 1.55;
}

.ajuda-painel__corpo {
  flex: 1;
  overflow-y: auto;
  overscroll-behavior: contain;
  padding: var(--space-4) var(--space-5) var(--space-8);
  scroll-behavior: smooth;
}
@media (max-width: 991.98px) {
  .ajuda-painel__corpo { padding-bottom: calc(var(--space-8) + env(safe-area-inset-bottom, 0px)); }
}

.ajuda-aviso-idioma {
  display: flex;
  gap: var(--space-2);
  align-items: flex-start;
  margin-bottom: var(--space-4);
  padding: var(--space-3);
  border-radius: var(--radius-control);
  background: var(--bg-muted);
  font-size: var(--text-sm);
  color: var(--text-secondary);
}

/* Indice "Neste guia" */
.ajuda-indice { margin-bottom: var(--space-5); }
.ajuda-indice__rotulo {
  margin: 0 0 var(--space-2);
  font-size: var(--text-xs);
  font-weight: var(--fw-semibold);
  color: var(--text-muted);
}
.ajuda-indice__lista {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-2);
  margin: 0;
  padding: 0;
  list-style: none;
}
.ajuda-indice__link {
  display: inline-flex;
  align-items: center;
  min-height: 32px;
  padding: 0 var(--space-3);
  border: 1px solid var(--border-color);
  border-radius: var(--radius-full);
  background: var(--bg-surface);
  color: var(--text-secondary);
  font-size: var(--text-sm);
  font-weight: var(--fw-medium);
  text-decoration: none;
  cursor: pointer;
  transition: background var(--dur-fast) var(--ease-out), color var(--dur-fast) var(--ease-out), border-color var(--dur-fast) var(--ease-out);
}
.ajuda-indice__link:hover { background: var(--color-primary-soft); color: var(--color-primary); border-color: transparent; }

/* Secoes */
.ajuda-secao { padding-top: var(--space-5); scroll-margin-top: var(--space-2); }
.ajuda-secao + .ajuda-secao { border-top: 1px solid var(--border-color); margin-top: var(--space-5); }
.ajuda-secao__titulo {
  margin: 0 0 var(--space-3);
  font-size: var(--text-base);
  font-weight: var(--fw-bold);
  line-height: var(--leading-tight);
  letter-spacing: -0.005em;
}
.ajuda-secao.is-realce .ajuda-secao__titulo {
  color: var(--color-primary);
}
.ajuda-secao.is-realce {
  animation: ajuda-realce 1.6s var(--ease-out) 1;
}
/* O realce sangra 10px para fora do texto (box-shadow da mesma cor), para o
   fundo nao encostar nas letras. */
.ajuda-secao.is-realce { border-radius: var(--radius-control); }
@keyframes ajuda-realce {
  0%, 30% { background: var(--color-primary-soft); box-shadow: 0 0 0 10px var(--color-primary-soft); }
  100% { background: transparent; box-shadow: 0 0 0 10px transparent; }
}

.ajuda-texto, .ajuda-painel p {
  font-size: var(--text-sm);
  line-height: 1.65;
  color: var(--text-secondary);
}
.ajuda-texto { margin: 0 0 var(--space-3); }
.ajuda-texto strong, .ajuda-passos strong, .ajuda-callout strong, .ajuda-faq strong { color: var(--text-primary); font-weight: var(--fw-semibold); }

/* [[Rotulo]] — nome de botao/campo do sistema, desenhado como etiqueta */
.ajuda-ui {
  display: inline-block;
  padding: 0 6px;
  border: 1px solid var(--border-color);
  border-radius: 6px;
  background: var(--bg-muted);
  color: var(--text-primary);
  font-size: 0.92em;
  font-weight: var(--fw-semibold);
  line-height: 1.5;
  white-space: nowrap;
}

/* Passo a passo */
.ajuda-passos {
  counter-reset: passo;
  margin: 0 0 var(--space-4);
  padding: 0;
  list-style: none;
}
.ajuda-passos li {
  counter-increment: passo;
  position: relative;
  padding: 0 0 var(--space-3) 40px;
  font-size: var(--text-sm);
  line-height: 1.65;
  color: var(--text-secondary);
}
.ajuda-passos li::before {
  content: counter(passo);
  position: absolute;
  left: 0;
  top: -1px;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 26px;
  height: 26px;
  border-radius: var(--radius-full);
  background: var(--color-primary-soft);
  color: var(--color-primary);
  font-size: var(--text-xs);
  font-weight: var(--fw-bold);
  font-variant-numeric: tabular-nums;
}
/* Fio que liga os numeros: le como sequencia, nao como lista solta */
.ajuda-passos li:not(:last-child)::after {
  content: '';
  position: absolute;
  left: 12px;
  top: 28px;
  bottom: 2px;
  width: 2px;
  border-radius: 1px;
  background: var(--border-color);
}

/* Etapas (linha do tempo com titulo) */
.ajuda-etapas { margin: 0 0 var(--space-4); padding: 0; list-style: none; }
.ajuda-etapas li {
  position: relative;
  padding: 0 0 var(--space-4) 28px;
}
.ajuda-etapas li::before {
  content: '';
  position: absolute;
  left: 4px;
  top: 6px;
  width: 10px;
  height: 10px;
  border-radius: var(--radius-full);
  border: 2px solid var(--color-primary);
  background: var(--bg-surface);
}
.ajuda-etapas li:not(:last-child)::after {
  content: '';
  position: absolute;
  left: 8px;
  top: 18px;
  bottom: 0;
  width: 2px;
  background: var(--border-color);
}
.ajuda-etapas__titulo {
  display: block;
  margin-bottom: 2px;
  font-size: var(--text-sm);
  font-weight: var(--fw-semibold);
  color: var(--text-primary);
}
.ajuda-etapas__texto { font-size: var(--text-sm); line-height: 1.6; color: var(--text-secondary); }

/* Avisos: atencao / perigo / dica.
   O fundo e a cor do tom MISTURADA com a superficie (color-mix): vale nos dois
   temas sem override — os *-soft de status sao quase brancos e virariam bloco
   brilhante no escuro. A cor do tom fica no fio e no icone (grafico, 3:1);
   o texto fica em text-primary/secondary, que passam 4.5:1 nos dois temas. */
.ajuda-callout {
  --tom: var(--color-info);
  display: flex;
  gap: var(--space-3);
  margin: 0 0 var(--space-4);
  padding: var(--space-3) var(--space-4);
  border-radius: var(--radius-control);
  border-left: 3px solid var(--tom);
  background: color-mix(in srgb, var(--tom) 9%, var(--bg-surface));
}
.ajuda-callout--atencao { --tom: var(--color-warning); }
.ajuda-callout--perigo { --tom: var(--color-danger); }
.ajuda-callout--dica { --tom: var(--color-success); }
.ajuda-callout__icone { color: var(--tom); padding-top: 2px; flex-shrink: 0; }
.ajuda-callout__titulo {
  display: block;
  margin-bottom: 2px;
  font-size: var(--text-sm);
  font-weight: var(--fw-bold);
  color: var(--text-primary);
}
.ajuda-callout__texto { margin: 0; font-size: var(--text-sm); line-height: 1.6; color: var(--text-secondary); }

/* Perguntas frequentes */
.ajuda-faq { margin: 0 0 var(--space-4); }
.ajuda-faq details {
  border: 1px solid var(--border-color);
  border-radius: var(--radius-control);
  background: var(--bg-surface);
}
.ajuda-faq details + details { margin-top: var(--space-2); }
.ajuda-faq summary {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--space-3);
  min-height: 44px;
  padding: var(--space-2) var(--space-3);
  font-size: var(--text-sm);
  font-weight: var(--fw-semibold);
  color: var(--text-primary);
  cursor: pointer;
  list-style: none;
}
.ajuda-faq summary::-webkit-details-marker { display: none; }
.ajuda-faq summary::after {
  content: '\f078';
  font-family: 'Font Awesome 6 Free';
  font-weight: 900;
  font-size: 0.7rem;
  color: var(--text-muted);
  transition: transform var(--dur-fast) var(--ease-out);
}
.ajuda-faq details[open] summary::after { transform: rotate(180deg); }
.ajuda-faq__resposta { padding: 0 var(--space-3) var(--space-3); font-size: var(--text-sm); line-height: 1.6; color: var(--text-secondary); }

/* Termos (glossario) */
.ajuda-termos { margin: 0 0 var(--space-4); }
.ajuda-termos dt { font-size: var(--text-sm); font-weight: var(--fw-semibold); color: var(--text-primary); }
.ajuda-termos dd { margin: 0 0 var(--space-3); font-size: var(--text-sm); line-height: 1.6; color: var(--text-secondary); }

/* Atalho para outra tela */
.ajuda-irpara {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  width: 100%;
  margin: 0 0 var(--space-4);
  padding: var(--space-3) var(--space-4);
  border: 1px solid var(--border-color);
  border-radius: var(--radius-control);
  background: var(--bg-surface);
  color: var(--text-primary);
  font-size: var(--text-sm);
  font-weight: var(--fw-semibold);
  text-align: left;
  text-decoration: none;
  transition: border-color var(--dur-fast) var(--ease-out), background var(--dur-fast) var(--ease-out);
}
.ajuda-irpara:hover { border-color: var(--color-primary); background: var(--color-primary-soft); color: var(--text-primary); }
.ajuda-irpara__icone { color: var(--color-primary); }
.ajuda-irpara__texto { flex: 1; min-width: 0; }
.ajuda-irpara__sub { display: block; font-weight: var(--fw-regular); color: var(--text-secondary); }

.ajuda-rodape {
  margin-top: var(--space-6);
  font-size: var(--text-xs);
  color: var(--text-muted);
}

.ajuda-erro { padding: var(--space-6) 0; text-align: center; color: var(--text-secondary); font-size: var(--text-sm); }

/* O PDV e tela cheia sem cabecalho: nada de painel la. */
.app-shell.layout-pdv ~ .ajuda-painel,
.app-shell.layout-pdv ~ .ajuda-fundo { display: none; }

@media (prefers-reduced-motion: reduce) {
  .ajuda-secao.is-realce { animation: none; }
  .ajuda-painel__corpo { scroll-behavior: auto; }
}