/* ============================================================================
 * scripts/docs/help.css — help-site overlay.
 *
 * Assumes static-base.css is loaded first (provides --bs-* and --theme-*
 * tokens plus typographic baseline). This file only adds article-shape
 * layout and directive-specific component styling.
 * ========================================================================== */

.guide-header {
  background-color: rgb(var(--theme-navbar-bg));
  background-image: var(--static-chrome-bg-image, none);
  background-repeat: var(--static-chrome-bg-repeat, repeat-x);
  background-size: auto;
  background-position: 0 0;
  color: rgb(var(--theme-navbar-color));
  border-bottom: 1px solid var(--bs-border-color);
}
.guide-header-inner {
  padding: 0.5rem 1rem;
  display: flex;
  align-items: center;
  gap: 1rem;
}
.guide-header-brand {
  display: inline-flex;
  align-items: center;
}
.guide-header-brand img {
  display: block;
  height: 40px;
  width: auto;
}
/* Driven by the navbar theme tokens — same source as the live navbar's
   font-family/size/weight (see client/src/index.css). */
.guide-header-section {
  font-family: var(--theme-navbar-font-family);
  font-size: var(--theme-navbar-font-size);
  font-weight: var(--theme-navbar-font-weight);
  color: rgb(var(--theme-navbar-color));
  border-left: 1px solid rgba(var(--theme-navbar-color), 0.35);
  padding-left: 1rem;
}
.guide-header a {
  color: rgb(var(--theme-navbar-color));
}
.guide-header a:hover, .guide-header a:focus {
  color: rgb(255, 255, 255);
  text-decoration: none;
}

/* Matches the main site's .container override (client/src/index.css#311):
   1280px cap with 15px gutters — single fluid-but-capped column instead of
   Bootstrap's stepped breakpoints. */
.guide-content {
  max-width: 1280px;
  margin: 2rem auto;
  padding: 0 15px;
}

.guide-content h1 {
  font-size: 2rem;
  border-bottom: 2px solid var(--bs-border-color);
  padding-bottom: 0.4rem;
  margin-top: 0;
}
.guide-content h2 {
  font-size: 1.45rem;
  margin-top: 2.5rem;
  border-bottom: 1px solid var(--bs-border-color);
  padding-bottom: 0.25rem;
}
.guide-content h3 { font-size: 1.15rem; margin-top: 1.75rem; }
.guide-content h4 { font-size: 1rem; margin-top: 1.25rem; }

.guide-content p, .guide-content li { font-size: 1.02rem; }

.guide-content code {
  font-size: 0.9em;
  background: var(--bs-tertiary-bg);
  padding: 0.1em 0.35em;
  border-radius: 3px;
  border: 1px solid var(--bs-border-color);
}
.guide-content pre {
  background: var(--bs-tertiary-bg);
  border: 1px solid var(--bs-border-color);
  border-radius: 4px;
  padding: 0.85rem 1rem;
  overflow-x: auto;
}
.guide-content pre code {
  background: transparent;
  border: 0;
  padding: 0;
}

.guide-content table {
  border-collapse: collapse;
  margin: 1.25rem 0;
  font-size: 0.95rem;
}
.guide-content th, .guide-content td {
  border: 1px solid var(--bs-border-color);
  padding: 0.45rem 0.7rem;
  text-align: left;
  vertical-align: top;
}
.guide-content th {
  background: var(--bs-tertiary-bg);
  font-weight: 600;
}

.guide-content blockquote {
  border-left: 3px solid var(--bs-primary);
  margin: 1rem 0;
  padding: 0.25rem 1rem;
  color: var(--bs-secondary);
  background: var(--bs-tertiary-bg);
}

/* Role-conditioned section (Phase 1: always visible with audience label) */
.guide-role {
  margin: 1.25rem 0;
  padding: 0.85rem 1rem;
  border-left: 4px solid var(--bs-primary);
  background: var(--bs-tertiary-bg);
  border-radius: 0 4px 4px 0;
}
.guide-role-label {
  font-size: 0.78rem;
  font-weight: 700;
  letter-spacing: 0.06em;
  margin: 0 0 0.5rem;
  color: var(--bs-primary);
}

/* Capture markers (screenshot / animation placeholders) */
.guide-capture {
  margin: 1.25rem 0;
  padding: 0.75rem 1rem;
  border: 1px dashed var(--bs-secondary);
  background: var(--bs-secondary-bg);
  border-radius: 4px;
}
.guide-capture-label {
  font-size: 0.78rem;
  font-weight: 700;
  letter-spacing: 0.06em;
  margin: 0 0 0.25rem;
  color: var(--bs-secondary);
}
.guide-capture-desc {
  margin: 0;
  font-size: 0.92rem;
  color: var(--bs-body-color);
}

/* Collapsible "under the hood" / advanced detail block */
.guide-details {
  margin: 1.25rem 0;
  padding: 0;
  border: 1px solid var(--bs-border-color);
  border-left: 3px solid var(--bs-secondary);
  border-radius: 0 4px 4px 0;
  background: var(--bs-tertiary-bg);
}
.guide-details-summary {
  padding: 0.55rem 0.85rem;
  cursor: pointer;
  font-size: 0.92rem;
  font-weight: 600;
  color: var(--bs-secondary);
  list-style: none;
  display: flex;
  align-items: center;
  gap: 0.4rem;
}
.guide-details-summary::-webkit-details-marker { display: none; }
.guide-details-summary::before {
  content: "▸";
  display: inline-block;
  font-size: 0.7em;
  transition: transform 0.15s ease;
  color: var(--bs-primary);
}
.guide-details[open] > .guide-details-summary::before {
  transform: rotate(90deg);
}
.guide-details-summary:hover { color: var(--bs-primary); }
.guide-details-body {
  padding: 0.25rem 0.85rem 0.75rem;
  font-size: 0.95rem;
  border-top: 1px solid var(--bs-border-color);
  background: var(--bs-body-bg);
}
.guide-details-body > :first-child { margin-top: 0.5rem; }
.guide-details-body > :last-child { margin-bottom: 0; }

/* Lead-in quote placeholder (sourcing-needed marker) */
.guide-quote-placeholder {
  margin: 1.5rem 0;
  padding: 0.85rem 1rem;
  border: 1px dashed var(--bs-primary);
  background: var(--bs-tertiary-bg);
  border-radius: 4px;
}
.guide-quote-label {
  font-size: 0.78rem;
  font-weight: 700;
  letter-spacing: 0.06em;
  color: var(--bs-primary);
  margin: 0 0 0.35rem;
}
.guide-quote-brief {
  margin: 0;
  font-size: 0.92rem;
  font-style: italic;
  color: var(--bs-secondary);
}

.guide-footer {
  background-color: rgb(var(--theme-footer-bg));
  background-image: var(--static-chrome-bg-image, none);
  background-repeat: var(--static-chrome-bg-repeat, repeat-x);
  color: rgb(var(--theme-footer-color));
  padding: 1.5rem 1.25rem;
  margin-top: 3rem;
  text-align: center;
  font-size: 0.9rem;
}
.guide-footer a {
  color: rgb(var(--theme-footer-color));
}
.guide-footer a:hover {
  color: rgb(255, 255, 255);
}