/**
 * user-guide.css — P5 Sprint 10 Task 10.1
 * =======================================
 * Slide-over User Guide panel for the Discovery Zone.
 *   - Same slide-over pattern as the About panel (dz-hub.css)
 *   - Accordion sections (open/collapse, state saved in localStorage)
 *   - Character-voice callouts (Sophie / Neil / Kappy / Gopala)
 *   - Inline KaTeX example blocks
 *
 * Brand: Ocean Blue #0D3B6E, Forest Green #2D6A4F, Sand Gold #C8963E
 * Characters: Kappy #0C4A6E, Gopala #15803D, Neil #F59E0B, Sophie #0F172A
 */

.discovery-zone {
  --ug-ocean: #0D3B6E;
  --ug-forest: #2D6A4F;
  --ug-gold: #C8963E;
  --ug-ink: #1F2933;
  --ug-line: #E2E8F0;
  --ug-bg-soft: #F5F8FB;
  --ug-white: #FFFFFF;
  --ug-shadow-lg: 0 18px 48px rgba(10, 45, 84, 0.28);
  --ug-char-sophie: #0F172A;
  --ug-char-neil: #F59E0B;
  --ug-char-gopala: #15803D;
  --ug-char-kappy: #0C4A6E;
}

/* -------------------------------------------------------------------------
   Toolbar trigger button (matches .dz-about-btn styling family)
   ------------------------------------------------------------------------- */
.dz-userguide-btn {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  min-height: 44px;
  padding: 9px 16px;
  border-radius: 999px;
  border: 2px solid var(--ug-ocean, #0D3B6E);
  background: #fff;
  color: var(--ug-ocean, #0D3B6E);
  font-weight: 700;
  font-size: 0.9rem;
  cursor: pointer;
  transition: background 0.18s ease, transform 0.18s ease, color 0.18s ease;
}

.dz-userguide-btn:hover {
  background: var(--ug-ocean, #0D3B6E);
  color: #fff;
}

.dz-userguide-btn:focus-visible {
  outline: 3px solid var(--ug-gold, #C8963E);
  outline-offset: 2px;
}

/* -------------------------------------------------------------------------
   Overlay + slide-over panel
   ------------------------------------------------------------------------- */
.dz-userguide-overlay {
  position: fixed;
  inset: 0;
  background: rgba(10, 45, 84, 0.42);
  opacity: 0;
  visibility: hidden;
  transition: opacity 0.24s ease, visibility 0.24s ease;
  z-index: 1300;
}

.dz-userguide-overlay.is-open {
  opacity: 1;
  visibility: visible;
}

.dz-userguide-panel {
  position: fixed;
  top: 0;
  right: 0;
  height: 100%;
  width: min(540px, 94vw);
  background: var(--ug-white);
  box-shadow: var(--ug-shadow-lg);
  transform: translateX(100%);
  transition: transform 0.28s cubic-bezier(0.22, 1, 0.36, 1);
  z-index: 1310;
  display: flex;
  flex-direction: column;
  overflow: hidden;
}

.dz-userguide-panel.is-open {
  transform: translateX(0);
}

.dz-userguide-header {
  flex-shrink: 0;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 12px;
  padding: 20px 24px;
  background: var(--ug-ocean);
  color: #fff;
}

.dz-userguide-header h2 {
  margin: 0;
  font-size: 1.28rem;
  color: #fff;
}

.dz-userguide-close {
  flex-shrink: 0;
  width: 40px;
  height: 40px;
  min-width: 40px;
  min-height: 40px;
  border-radius: 50%;
  border: none;
  background: rgba(255, 255, 255, 0.16);
  color: #fff;
  font-size: 1.4rem;
  line-height: 1;
  cursor: pointer;
  transition: background 0.18s ease;
}

.dz-userguide-close:hover {
  background: rgba(255, 255, 255, 0.3);
}

.dz-userguide-close:focus-visible {
  outline: 3px solid var(--ug-gold);
  outline-offset: 2px;
}

.dz-userguide-body {
  flex: 1 1 auto;
  overflow-y: auto;
  padding: 20px 24px 32px;
}

.dz-userguide-intro {
  color: var(--ug-ink);
  line-height: 1.6;
  margin: 0 0 18px;
  font-size: 0.98rem;
}

/* -------------------------------------------------------------------------
   Accordion sections
   ------------------------------------------------------------------------- */
.ug-accordion {
  border: 1px solid var(--ug-line);
  border-radius: 10px;
  margin-bottom: 12px;
  overflow: hidden;
  background: #fff;
}

.ug-accordion-trigger {
  width: 100%;
  min-height: 44px;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 12px;
  padding: 14px 16px;
  background: var(--ug-bg-soft);
  border: none;
  cursor: pointer;
  text-align: left;
  font-family: inherit;
  font-size: 1rem;
  font-weight: 700;
  color: var(--ug-ocean);
  transition: background 0.18s ease;
}

.ug-accordion-trigger:hover {
  background: #eaf1f8;
}

.ug-accordion-trigger:focus-visible {
  outline: 3px solid var(--ug-gold);
  outline-offset: -3px;
}

.ug-accordion-num {
  flex-shrink: 0;
  width: 26px;
  height: 26px;
  border-radius: 50%;
  background: var(--ug-ocean);
  color: #fff;
  font-size: 0.85rem;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  margin-right: 4px;
}

.ug-accordion-label {
  flex: 1 1 auto;
}

.ug-accordion-chevron {
  flex-shrink: 0;
  transition: transform 0.2s ease;
  color: var(--ug-forest);
  font-size: 0.9rem;
}

.ug-accordion-trigger[aria-expanded="true"] .ug-accordion-chevron {
  transform: rotate(180deg);
}

.ug-accordion-content {
  padding: 16px;
  border-top: 1px solid var(--ug-line);
}

.ug-accordion-content[hidden] {
  display: none;
}

.ug-accordion-content p {
  color: var(--ug-ink);
  line-height: 1.6;
  margin: 0 0 12px;
}

.ug-accordion-content p:last-child {
  margin-bottom: 0;
}

/* -------------------------------------------------------------------------
   Character voice callouts (consistent with character-voice.css)
   ------------------------------------------------------------------------- */
.ug-callout {
  display: flex;
  gap: 10px;
  align-items: flex-start;
  padding: 12px 14px;
  margin: 0 0 12px;
  background: #F8FAFB;
  border-left: 4px solid var(--ug-ocean);
  border-radius: 8px;
}

.ug-callout-avatar {
  flex-shrink: 0;
  width: 34px;
  height: 34px;
  border-radius: 50%;
  color: #fff;
  font-weight: 700;
  font-size: 0.9rem;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.12);
}

.ug-callout-text {
  flex: 1 1 auto;
}

.ug-callout-name {
  font-weight: 700;
  font-size: 0.9rem;
  margin: 0 0 3px;
  display: flex;
  align-items: baseline;
  gap: 6px;
}

.ug-callout-role {
  font-weight: 400;
  font-size: 0.78rem;
  color: #667;
  font-style: italic;
}

.ug-callout-speech {
  margin: 0;
  color: var(--ug-ink);
  line-height: 1.55;
  font-size: 0.96rem;
}

/* Per-character color coding (left border + avatar) */
.ug-callout[data-character="sophie"] { border-left-color: var(--ug-char-sophie); }
.ug-callout[data-character="sophie"] .ug-callout-avatar { background: var(--ug-char-sophie); }
.ug-callout[data-character="sophie"] .ug-callout-name { color: var(--ug-char-sophie); }

.ug-callout[data-character="neil"] { border-left-color: var(--ug-char-neil); }
.ug-callout[data-character="neil"] .ug-callout-avatar { background: var(--ug-char-neil); color: #3a2c00; }
.ug-callout[data-character="neil"] .ug-callout-name { color: #9a6b00; }

.ug-callout[data-character="gopala"] { border-left-color: var(--ug-char-gopala); }
.ug-callout[data-character="gopala"] .ug-callout-avatar { background: var(--ug-char-gopala); }
.ug-callout[data-character="gopala"] .ug-callout-name { color: var(--ug-char-gopala); }

.ug-callout[data-character="kappy"] { border-left-color: var(--ug-char-kappy); }
.ug-callout[data-character="kappy"] .ug-callout-avatar { background: var(--ug-char-kappy); }
.ug-callout[data-character="kappy"] .ug-callout-name { color: var(--ug-char-kappy); }

/* -------------------------------------------------------------------------
   Inline KaTeX example block
   ------------------------------------------------------------------------- */
.ug-example {
  background: var(--ug-bg-soft);
  border: 1px solid var(--ug-line);
  border-radius: 8px;
  padding: 12px 14px;
  margin: 0 0 12px;
}

.ug-example-label {
  display: block;
  font-size: 0.78rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--ug-forest);
  margin-bottom: 6px;
}

.ug-example .katex-expr {
  font-size: 1.05rem;
}

/* -------------------------------------------------------------------------
   Screenshot-style static example card (section 3)
   ------------------------------------------------------------------------- */
.ug-shot {
  border: 1px dashed var(--ug-forest);
  border-radius: 8px;
  padding: 14px;
  margin: 0 0 12px;
  background: #fff;
}

.ug-shot-term {
  display: inline-block;
  border-bottom: 2px dotted var(--ug-forest);
  color: var(--ug-ocean);
  font-weight: 700;
  cursor: help;
}

.ug-shot-popup {
  margin-top: 10px;
  border: 2px solid var(--ug-ocean);
  border-radius: 8px;
  padding: 10px 12px;
  max-width: 300px;
  box-shadow: 0 6px 18px rgba(10, 45, 84, 0.16);
}

.ug-shot-popup .id {
  color: var(--ug-forest);
  font-weight: 700;
  font-size: 0.85rem;
}

.ug-shot-popup .name {
  font-weight: 700;
  color: var(--ug-ocean);
  margin: 2px 0;
}

.ug-shot-popup .def {
  color: var(--ug-ink);
  font-size: 0.9rem;
  line-height: 1.5;
}

/* Color key inline (section 2) */
.ug-colorkey {
  display: flex;
  flex-direction: column;
  gap: 6px;
  margin: 0 0 12px;
}

.ug-colorkey-row {
  display: flex;
  align-items: center;
  gap: 10px;
  font-size: 0.92rem;
  color: var(--ug-ink);
}

.ug-colorkey-swatch {
  flex-shrink: 0;
  width: 26px;
  height: 26px;
  border-radius: 6px;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  color: #fff;
  font-weight: 700;
  font-size: 0.85rem;
}

.ug-colorkey-swatch.coherent { background: #C0392B; }
.ug-colorkey-swatch.resonant { background: #27AE60; }
.ug-colorkey-swatch.expansive { background: #1565C0; }

/* Derivation-path ✓ badge illustration (section 4) */
.ug-badge {
  display: inline-flex;
  align-items: center;
  gap: 5px;
  padding: 3px 9px;
  border-radius: 999px;
  background: #E7F5EC;
  color: #15803D;
  font-weight: 700;
  font-size: 0.82rem;
}

/* Worked-step list (section 6) */
.ug-steps {
  counter-reset: ug-step;
  list-style: none;
  padding: 0;
  margin: 0 0 12px;
}

.ug-steps li {
  position: relative;
  padding: 8px 8px 8px 40px;
  margin-bottom: 8px;
  background: var(--ug-bg-soft);
  border-radius: 8px;
  color: var(--ug-ink);
  line-height: 1.5;
}

.ug-steps li::before {
  counter-increment: ug-step;
  content: counter(ug-step);
  position: absolute;
  left: 8px;
  top: 8px;
  width: 24px;
  height: 24px;
  border-radius: 50%;
  background: var(--ug-forest);
  color: #fff;
  font-weight: 700;
  font-size: 0.82rem;
  display: inline-flex;
  align-items: center;
  justify-content: center;
}

/* -------------------------------------------------------------------------
   Responsive
   ------------------------------------------------------------------------- */
@media (max-width: 560px) {
  .dz-userguide-btn span.dz-userguide-btn-label {
    display: none;
  }
  .dz-userguide-panel {
    width: 100vw;
  }
}

/* -------------------------------------------------------------------------
   Reduced motion
   ------------------------------------------------------------------------- */
@media (prefers-reduced-motion: reduce) {
  .dz-userguide-panel,
  .dz-userguide-overlay,
  .dz-userguide-btn,
  .ug-accordion-chevron,
  .ug-accordion-trigger {
    transition: none !important;
  }
}