/* Hilfe -- kleine Infobox an einem Symbol, fuer Erklaertexte im Fliesstext,
   an Bedienelementen und in Kopfzeilen.

   Herkunft: die Optik stammt aus dem Tabellenmodul (.dt-help / .dt-help-pop,
   table.css 211-246). Dort war sie fest in DataTable verdrahtet, mit einer
   hart kodierten id="dtHilfe". Sobald zwei Hilfen auf einer Seite stehen,
   kollidieren die IDs und aria-describedby zeigt ins Leere. Deshalb hier als
   eigenstaendige Komponente mit erzeugter ID. Optik bleibt unveraendert,
   damit bestehende Seiten nicht springen.

   Ergaenzt gegenueber der Tabellenfassung:
   - Aussenklick schliesst (auf dem Handy war die Box sonst nur ueber das
     Symbol selbst wieder zuzubekommen, Escape gibt es dort nicht).
   - Unterhalb 480px sitzt die Box als schmale Leiste ueber die Breite statt
     rechtsbuendig unter dem Symbol, sonst haengt sie halb im Nichts.
   - Ausrichtung links oder rechts ueber data-hilfe-seite.

   Laedt NACH https://ui.1.ki/theme/1ki-theme.css.
   Alle Farben und Abstaende kommen aus dem Theme, hier stehen keine rohen
   Hex-Werte -- damit greifen die Darstellungsstufen aus a11y.css automatisch.

   Version: 1.0 (2026-08-06)
*/

.hilfe {
  position: relative;
  display: inline-flex;
  vertical-align: baseline;
}

/* Das Symbol. Standard ist das Fragezeichen in einem Kreis, wie in der
   Tabelle. Ein anderes Symbol kommt als Kindelement mit, dann tritt der
   Kreis zurueck (siehe .hilfe-schlicht). */
.hilfe > button {
  width: 22px;
  height: 22px;
  border-radius: 50%;
  border: 1px solid var(--line-strong);
  background: transparent;
  color: var(--text-muted);
  font: inherit;
  font-size: 12px;
  font-weight: var(--fw-semibold);
  line-height: 1;
  cursor: help;
  padding: 0;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  transition: border-color var(--t-fast), color var(--t-fast);
}

.hilfe > button:hover,
.hilfe > button[aria-expanded="true"] {
  border-color: var(--sky);
  color: var(--sky);
}

/* Schlichte Variante: nur das Symbol, kein Kreis. Fuer Stellen, an denen
   der Kreis zu laut waere -- etwa in der Breadcrumb-Zeile, die bewusst
   leise bleibt. */
.hilfe-schlicht > button {
  width: auto;
  height: auto;
  border: 0;
  border-radius: var(--radius-sm);
  padding: 2px;
  margin: -2px 0;
}

.hilfe-schlicht > button:hover,
.hilfe-schlicht > button[aria-expanded="true"] {
  border-color: transparent;
  color: var(--sky);
}

.hilfe > button svg {
  width: 1em;
  height: 1em;
  display: block;
  fill: none;
  stroke: currentColor;
  stroke-width: 1.9;
  stroke-linecap: round;
  stroke-linejoin: round;
}

/* Die Box. Standard rechtsbuendig unter dem Symbol, weil Hilfen meist am
   rechten Rand einer Leiste sitzen. */
.hilfe-pop {
  position: absolute;
  right: 0;
  top: calc(100% + 8px);
  z-index: 80;
  width: min(340px, 78vw);
  padding: var(--space-4);
  border: 1px solid var(--line-strong);
  border-radius: var(--radius);
  background: var(--surface-2);
  box-shadow: var(--shadow);
  font-size: var(--fs-xs);
  line-height: 1.55;
  color: var(--text);
  text-align: left;
  opacity: 0;
  visibility: hidden;
  transform: translateY(-4px);
  transition: opacity var(--t-fast), transform var(--t-fast), visibility var(--t-fast);
}

.hilfe[data-hilfe-seite="links"] .hilfe-pop {
  right: auto;
  left: 0;
}

.hilfe:hover .hilfe-pop,
.hilfe:focus-within .hilfe-pop,
.hilfe-pop[data-open="true"] {
  opacity: 1;
  visibility: visible;
  transform: translateY(0);
}

.hilfe-pop p {
  margin: 0 0 var(--space-3);
}

.hilfe-pop > :last-child {
  margin-bottom: 0;
}

.hilfe-pop strong {
  color: var(--text-strong);
}

/* Begriffspaare, wie sie die Tabellenhilfe fuer die Vergleichsoperatoren
   nutzt. Hier allgemein verfuegbar. */
.hilfe-pop dl {
  margin: 0;
  display: grid;
  grid-template-columns: auto 1fr;
  gap: 5px 10px;
}

.hilfe-pop dt {
  font-weight: var(--fw-semibold);
  color: var(--text-strong);
  white-space: nowrap;
}

.hilfe-pop dd {
  margin: 0;
  color: var(--text-muted);
}

/* Auf schmalen Geraeten spannt die Box ueber die Breite des Bildschirms,
   statt rechtsbuendig am Symbol zu haengen. Ohne das steht sie bei einem
   Symbol am linken Rand zur Haelfte ausserhalb. */
@media (max-width: 480px) {
  .hilfe-pop,
  .hilfe[data-hilfe-seite="links"] .hilfe-pop {
    position: fixed;
    left: var(--space-3);
    right: var(--space-3);
    top: auto;
    width: auto;
    max-width: none;
  }
}

/* Erklaertexte gehoeren nicht aufs Papier. */
@media print {
  .hilfe { display: none !important; }
}