/* Hilfe: Knopf in der Filterleiste, Einführung als Dialog, Hinweis beim
   ersten Besuch (js/ui/help.js, js/ui/helpHint.js). */

/* --- Der Knopf ----------------------------------------------------------
   Steht in der Kopfzeile des Filterbereichs unter "Filter" und
   "Ausflugsplan" und übernimmt deshalb deren Form (siehe .trip-filter__btn
   in css/trips.css) - drei verschieden aussehende Knöpfe übereinander wären
   eine Leiste ohne Ordnung. */

.help-btn {
  display: flex;
  align-items: center;
  gap: var(--space-xs);
  flex-shrink: 0;
  padding: var(--space-sm) var(--space-md);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-sm);
  background: var(--color-surface);
  color: var(--color-text);
  font: inherit;
  font-weight: 600;
  cursor: pointer;
}

.help-btn:hover,
.help-btn:focus-visible {
  border-color: var(--color-primary);
  color: var(--color-primary-dark);
}

/* Das Fragezeichen im Kreis: dieselbe Kantenlänge wie Trichter und Wegweiser
   daneben (18px), damit die drei Knöpfe auf gleicher Höhe stehen. */
.help-btn__icon {
  display: flex;
  align-items: center;
  justify-content: center;
  width: 18px;
  height: 18px;
  flex-shrink: 0;
  border: 1.5px solid currentColor;
  border-radius: 50%;
  font-size: 0.72rem;
  font-weight: 700;
  line-height: 1;
}

/* Bei offener Leiste teilt sich die Kopfzeile den Platz mit Titel und
   Schliessen-Knopf. Dort bleibt nur das Zeichen übrig - erreichbar bleibt
   die Hilfe damit an derselben Stelle, ohne dass der Titel zerquetscht wird
   oder eine dritte Zeile aufgeht. */
.filter-panel--open .help-btn {
  padding: var(--space-xs);
  border-color: transparent;
}

.filter-panel--open .help-btn__label {
  /* Nicht visibility: hidden - der Platz soll wirklich frei werden. Die
     Beschriftung für Screenreader steckt im aria-label des Knopfes und
     bleibt davon unberührt. */
  display: none;
}

.filter-panel--open .help-btn__icon {
  width: 24px;
  height: 24px;
  font-size: 0.9rem;
}

@media (min-width: 1024px) {
  /* Zugeklappte Spalte (56px): Zeichen und Wort untereinander, wie beim
     Filter- und beim Plan-Knopf darüber. */
  .filter-panel:not(.filter-panel--open) .help-btn {
    flex-direction: column;
    gap: var(--space-xs);
    width: 100%;
    padding: var(--space-sm) var(--space-xs);
  }

  .filter-panel:not(.filter-panel--open) .help-btn__icon {
    width: 22px;
    height: 22px;
    font-size: 0.85rem;
  }

  .filter-panel:not(.filter-panel--open) .help-btn__label {
    font-size: 0.7rem;
    letter-spacing: 0.03em;
  }
}

/* --- Die Einführung -----------------------------------------------------
   Setzt auf .auth-modal/.auth-dialog auf (css/auth.css) - gleicher Rahmen,
   gleiches Verhalten beim Blättern auf kleinen Anzeigen. Nur breiter: hier
   stehen Screenshots drin, und 26rem sind dafür zu schmal. */

.help-dialog {
  max-width: 44rem;
}

.help-slide {
  display: flex;
  flex-direction: column;
  gap: var(--space-md);
}

.help-slide__title {
  font-size: 1.05rem;
  font-weight: 700;
}

/* Getönte Fläche hinter dem Bild: Screenshots vom Handy sind hochkant und
   füllen die Breite des Dialogs nie aus. Ohne Hintergrund stünde das Bild in
   einem weissen Nichts, mit ihm sieht der Rand nach Absicht aus. */
.help-slide__figure {
  display: flex;
  justify-content: center;
  background: var(--color-background);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  padding: var(--space-sm);
}

/* Höhe begrenzen statt Breite: sonst wäre ein hochkantes Bild höher als der
   Bildschirm und der Text darunter unerreichbar. */
.help-slide__image {
  display: block;
  max-width: 100%;
  max-height: 42vh;
  width: auto;
  height: auto;
  border-radius: var(--radius-sm);
}

.help-slide__text {
  line-height: 1.5;
}

/* Bewusst kein Flex-Container: In einem solchen verlieren die Einträge ihre
   Aufzählungszeichen (die Browser machen aus display: list-item dann
   display: block). Das Reset nimmt Listen die Punkte ab, hier bekommen sie
   sie zurück - eine Aufzählung ohne Punkte liest sich wie ein zerhackter
   Absatz. */
.help-slide__points {
  margin: 0;
  padding-left: var(--space-lg);
  line-height: 1.45;
}

.help-slide__points li {
  list-style: disc;
}

.help-slide__points li + li {
  margin-top: var(--space-xs);
}

/* --- Fußzeile mit Blätterung ------------------------------------------- */

.help-dialog__footer {
  display: flex;
  flex-direction: column;
  gap: var(--space-sm);
  margin-top: var(--space-lg);
  padding-top: var(--space-md);
  border-top: 1px solid var(--color-border);
}

.help-dots {
  display: flex;
  justify-content: center;
  gap: var(--space-sm);
}

/* Die Punkte sind bedienbar, nicht nur Anzeige - damit lässt sich zu dem
   Thema springen, wegen dem man die Hilfe geöffnet hat. Die Trefferfläche
   ist deshalb deutlich grösser als der sichtbare Punkt. */
.help-dot {
  width: 24px;
  height: 24px;
  padding: 0;
  border: none;
  background: none;
  cursor: pointer;
  position: relative;
}

.help-dot::after {
  content: '';
  position: absolute;
  top: 50%;
  left: 50%;
  width: 9px;
  height: 9px;
  transform: translate(-50%, -50%);
  border-radius: 50%;
  background: var(--color-border);
  transition: background-color 140ms ease;
}

.help-dot:hover::after,
.help-dot:focus-visible::after {
  background: var(--color-text-muted);
}

.help-dot--active::after {
  background: var(--color-primary);
  width: 11px;
  height: 11px;
}

.help-dialog__progress {
  font-size: 0.85rem;
  color: var(--color-text-muted);
  text-align: center;
}

.help-dialog__nav {
  display: flex;
  gap: var(--space-sm);
}

.help-dialog__nav .btn {
  flex: 1;
  min-height: 44px;
}

@media (min-width: 40rem) {
  /* Ab Tablet nebeneinander: Seitenzahl links, Knöpfe rechts. */
  .help-dialog__footer {
    display: grid;
    grid-template-columns: 1fr auto;
    align-items: center;
    row-gap: var(--space-sm);
  }

  .help-dots {
    grid-column: 1 / -1;
  }

  .help-dialog__progress {
    text-align: left;
  }

  .help-dialog__nav .btn {
    flex: 0 0 auto;
    min-width: 7rem;
  }
}

/* --- Hinweis beim ersten Besuch ----------------------------------------
   Frei im Fenster positioniert (js/ui/helpHint.js rechnet left/top aus),
   nicht im Fluss: Der Knopf steht in der Filterspalte, und die schneidet
   ihren Inhalt ab. Eine Blase darin wäre unsichtbar. */

.help-hint {
  position: fixed;
  z-index: 1060;
  width: min(19rem, calc(100vw - 2 * var(--space-md)));
  padding: var(--space-md);
  background: var(--color-surface);
  border: 1px solid var(--color-primary);
  border-radius: var(--radius-md);
  box-shadow: 0 6px 20px rgba(0, 0, 0, 0.22);
  animation: help-hint-in 180ms ease-out;
}

.help-hint[hidden] {
  display: none;
}

/* Während des Messens: schon im Layout, aber noch nicht zu sehen - sonst
   blitzte die Blase kurz oben links auf, bevor sie an ihren Platz springt. */
.help-hint--measuring {
  visibility: hidden;
  animation: none;
}

/* Der Pfeil ist ein gedrehtes Quadrat, das zur Hälfte aus der Blase ragt;
   zwei Kanten tragen den Rahmen, die anderen beiden verschwinden hinter der
   Blase. --help-hint-arrow setzt js/ui/helpHint.js auf die Mitte des
   Knopfes. */
.help-hint::after {
  content: '';
  position: absolute;
  width: 14px;
  height: 14px;
  background: var(--color-surface);
  border: 1px solid var(--color-primary);
}

/* Blase links vom Knopf (Spaltenansicht): Pfeil zeigt nach rechts. */
.help-hint--left::after {
  right: -8px;
  top: var(--help-hint-arrow, 50%);
  transform: translateY(-50%) rotate(45deg);
  border-left: none;
  border-bottom: none;
}

/* Blase unter dem Knopf (schmale Anzeigen): Pfeil zeigt nach oben. */
.help-hint--below::after {
  top: -8px;
  left: var(--help-hint-arrow, 50%);
  transform: translateX(-50%) rotate(45deg);
  border-right: none;
  border-bottom: none;
}

.help-hint__inner {
  display: flex;
  flex-direction: column;
  gap: var(--space-sm);
}

.help-hint__title {
  font-weight: 700;
}

.help-hint__text {
  font-size: 0.9rem;
  line-height: 1.45;
  color: var(--color-text);
}

.help-hint__actions {
  display: flex;
  gap: var(--space-sm);
}

.help-hint__btn {
  flex: 1;
  min-height: 40px;
}

@keyframes help-hint-in {
  from {
    opacity: 0;
    transform: scale(0.96);
  }
  to {
    opacity: 1;
    transform: none;
  }
}

@media (prefers-reduced-motion: reduce) {
  .help-hint {
    animation: none;
  }

  .help-dot::after {
    transition: none;
  }
}
