/*
 * css/help.css — In-app Help Center (drawer + Help page + fragment content)
 *
 * Theme-aware: relies on Bootstrap 5.3 CSS variables (--bs-*) so everything
 * adapts automatically to data-bs-theme="light" | "dark". Inline SVG diagrams
 * in fragments use `currentColor` and these variables — never hard-coded hex.
 */

/* ── Shared fragment article ─────────────────────────────────────────────── */
.help-article {
  font-size: 0.95rem;
  line-height: 1.55;
}
.help-article h4 { font-weight: 600; }
.help-article-body h5,
.help-article-body h6 {
  font-weight: 600;
  margin-top: 1.25rem;
  margin-bottom: 0.5rem;
}
.help-article-body > :first-child { margin-top: 0; }

/* Hero illustration */
.help-hero {
  margin: 0.5rem 0 1rem;
  border: 1px solid var(--bs-border-color);
  border-radius: 0.75rem;
  overflow: hidden;
  background: var(--bs-tertiary-bg, var(--bs-light));
}
.help-hero img {
  display: block;
  width: 100%;
  height: auto;
}

/* "Who can use this" callout */
.help-roles {
  display: flex;
  flex-wrap: wrap;
  gap: 0.4rem;
  align-items: center;
  padding: 0.6rem 0.75rem;
  border-left: 3px solid var(--bs-primary);
  background: color-mix(in srgb, var(--bs-primary) 8%, transparent);
  border-radius: 0.4rem;
  margin-bottom: 1rem;
}
.help-roles .badge { font-weight: 500; }

/* Key concepts list */
.help-concepts {
  list-style: none;
  padding-left: 0;
  margin-bottom: 1rem;
}
.help-concepts > li {
  padding: 0.35rem 0;
  border-bottom: 1px dashed var(--bs-border-color);
}
.help-concepts > li:last-child { border-bottom: 0; }
.help-concepts .term { font-weight: 600; }

/* Step-by-step workflow */
.help-steps {
  list-style: none;
  counter-reset: help-step;
  padding-left: 0;
  margin: 0 0 1rem;
}
.help-steps > li {
  position: relative;
  padding: 0.25rem 0 0.9rem 2.4rem;
  counter-increment: help-step;
}
.help-steps > li::before {
  content: counter(help-step);
  position: absolute;
  left: 0;
  top: 0;
  width: 1.7rem;
  height: 1.7rem;
  border-radius: 50%;
  background: var(--bs-primary);
  color: #fff;
  font-size: 0.85rem;
  font-weight: 600;
  display: flex;
  align-items: center;
  justify-content: center;
}
.help-steps > li:not(:last-child)::after {
  content: "";
  position: absolute;
  left: 0.83rem;
  top: 1.7rem;
  bottom: 0;
  width: 2px;
  background: var(--bs-border-color);
}
.help-step-title { font-weight: 600; }

/* Tips & gotchas */
.help-tip,
.help-warning {
  display: flex;
  gap: 0.6rem;
  padding: 0.6rem 0.75rem;
  border-radius: 0.4rem;
  margin-bottom: 0.6rem;
}
.help-tip {
  background: color-mix(in srgb, var(--bs-success) 10%, transparent);
  border: 1px solid color-mix(in srgb, var(--bs-success) 30%, transparent);
}
.help-warning {
  background: color-mix(in srgb, var(--bs-warning) 14%, transparent);
  border: 1px solid color-mix(in srgb, var(--bs-warning) 35%, transparent);
}
.help-tip .bi { color: var(--bs-success); }
.help-warning .bi { color: var(--bs-warning-text-emphasis, var(--bs-warning)); }

/* Related pages */
.help-related {
  display: flex;
  flex-wrap: wrap;
  gap: 0.4rem;
  margin-top: 0.5rem;
}
.help-related .help-related-link {
  text-decoration: none;
  border: 1px solid var(--bs-border-color);
  border-radius: 2rem;
  padding: 0.2rem 0.7rem;
  font-size: 0.85rem;
  color: var(--bs-body-color);
  background: var(--bs-body-bg);
  cursor: pointer;
}
.help-related .help-related-link:hover {
  border-color: var(--bs-primary);
  color: var(--bs-primary);
}

/* ── Inline SVG workflow diagrams ────────────────────────────────────────── */
.help-diagram {
  margin: 0.75rem 0 1.25rem;
  padding: 0.75rem;
  border: 1px solid var(--bs-border-color);
  border-radius: 0.6rem;
  background: var(--bs-tertiary-bg, var(--bs-body-bg));
  overflow-x: auto;
}
.help-diagram svg {
  display: block;
  max-width: 100%;
  height: auto;
  /* Diagrams draw with currentColor for theme-aware strokes/text */
  color: var(--bs-body-color);
}
.help-diagram .hd-node {
  fill: var(--bs-body-bg);
  stroke: var(--bs-border-color);
}
.help-diagram .hd-node-primary { fill: color-mix(in srgb, var(--bs-primary) 14%, var(--bs-body-bg)); stroke: var(--bs-primary); }
.help-diagram .hd-node-success { fill: color-mix(in srgb, var(--bs-success) 14%, var(--bs-body-bg)); stroke: var(--bs-success); }
.help-diagram .hd-node-warning { fill: color-mix(in srgb, var(--bs-warning) 16%, var(--bs-body-bg)); stroke: var(--bs-warning); }
.help-diagram .hd-label { fill: var(--bs-body-color); font-size: 13px; }
.help-diagram .hd-sub { fill: var(--bs-secondary-color); font-size: 11px; }
.help-diagram .hd-edge { stroke: var(--bs-secondary-color); fill: none; }
.help-diagram .hd-edge-arrow { fill: var(--bs-secondary-color); }
.help-diagram .hd-edge-label { fill: var(--bs-secondary-color); font-size: 11px; }

/* ── Contextual drawer ───────────────────────────────────────────────────── */
.help-offcanvas .offcanvas-body { padding-top: 1rem; }
.help-drawer-footer { position: sticky; bottom: 0; background: var(--bs-body-bg); }

/* ── Comprehensive Help page ─────────────────────────────────────────────── */
.help-page-layout {
  display: grid;
  grid-template-columns: minmax(220px, 280px) 1fr;
  gap: 1rem;
  align-items: start;
}
.help-page-sidebar { position: sticky; top: 0.5rem; }
.help-search-wrap { position: relative; }
.help-search-icon {
  position: absolute;
  left: 0.6rem;
  top: 50%;
  transform: translateY(-50%);
  color: var(--bs-secondary-color);
  pointer-events: none;
}
.help-search-input { padding-left: 2rem; }

.help-index-group-title { letter-spacing: 0.04em; }
.help-index .list-group-item {
  border: 0;
  border-radius: 0.4rem;
  padding: 0.45rem 0.6rem;
  background: transparent;
  cursor: pointer;
}
.help-index .list-group-item:hover {
  background: var(--bs-secondary-bg, rgba(0,0,0,0.05));
}
.help-index .list-group-item.active {
  background: var(--bs-primary);
  color: #fff;
}

.help-page-content {
  padding: 1.25rem 1.5rem;
  min-height: 60vh;
}

@media (max-width: 768px) {
  .help-page-layout { grid-template-columns: 1fr; }
  .help-page-sidebar { position: static; }
}
