/*
 * Contextual help: header control, drawer, manual pages, live UI elements and Show me.
 * Builds on the Cartzilla/Bootstrap theme; no rules here restyle existing app components.
 */

:root {
  /* Defaults; header-base.php emits contrast-checked values from Core\Help::themeCss(). */
  --help-accent: var(--division-primary);
  --help-on-accent: #fff;
  --help-accent-text: var(--division-primary);
  --help-tint: rgba(var(--division-primary-rgb), .08);
  --help-focus: var(--division-primary);
  --help-rgb: var(--division-primary-rgb);
  --help-measure: 44rem;      /* article column: about 75 characters per line */
  --help-toc-width: 14rem;
  --help-drawer-width: 420px;
}

/* ---------- Header Help control ---------- */
.help-trigger {
  display: inline-flex;
  align-items: center;
  gap: .375rem;
  min-height: 2.75rem;
  padding: 0 .875rem;
  border-radius: 999px;
  border: 0;
  background: transparent;
  color: var(--cz-heading-color);
  font-weight: 500;
  font-size: .875rem;
}
.help-trigger i { font-size: 1.25rem; }
.help-trigger:hover { background: var(--cz-tertiary-bg); }
@media (max-width: 575.98px) {
  .help-trigger { padding: 0 .5rem; gap: .25rem; font-size: .75rem; }
}

/* Visible, contrast-checked focus everywhere inside help UI */
.help-scope :focus-visible,
.help-trigger:focus-visible,
.help-showme-bar button:focus-visible {
  outline: 3px solid var(--help-focus) !important;
  outline-offset: 2px !important;
  box-shadow: 0 0 0 5px var(--cz-body-bg) !important;
}

/* ---------- Drawer ---------- */
.help-drawer.offcanvas {
  --cz-offcanvas-width: var(--help-drawer-width);
  --cz-offcanvas-padding-x: 1.25rem;
  display: flex;
  flex-direction: column;
}
@media (max-width: 575.98px) {
  .help-drawer.offcanvas { --cz-offcanvas-width: 100%; border-left: 0; }
}
/* A tint of the division colour, not the solid colour: a solid band is too heavy in light mode. */
.help-drawer__head {
  background: rgba(var(--help-rgb), .12);
  border-bottom: 1px solid rgba(var(--help-rgb), .25);
  color: var(--cz-heading-color);
  padding: .875rem 1rem 1rem 1.25rem;
}
[data-bs-theme=dark] .help-drawer__head { background: rgba(var(--help-rgb), .2); }
.help-drawer__brand {
  display: flex;
  align-items: center;
  gap: .5rem;
  font-size: .8125rem;
  font-weight: 500;
  opacity: .92;
}
.help-drawer__mark {
  width: 1.625rem;
  height: 1.625rem;
  border-radius: 50%;
  display: grid;
  place-items: center;
  font-size: .75rem;
  font-weight: 700;
  background: var(--help-accent);
  color: var(--help-on-accent);
}
.help-drawer__title {
  color: inherit;
  font-size: 1.25rem;
  line-height: 1.3;
  margin: .625rem 0 0;
  text-wrap: balance;
}
.help-drawer__close {
  margin-left: auto;
  width: 2.75rem;
  height: 2.75rem;
  border: 0;
  border-radius: 50%;
  background: transparent;
  color: inherit;
  display: grid;
  place-items: center;
  font-size: 1.25rem;
}
.help-drawer__close:hover { background: rgba(127,127,127,.18); }
.help-drawer__nav {
  display: flex;
  align-items: center;
  gap: .5rem;
  padding: .75rem 1.25rem;
  border-bottom: 1px solid var(--cz-border-color);
  background: var(--cz-body-bg);
}
.help-drawer__nav .form-control { min-height: 2.75rem; }
.help-back {
  display: inline-flex;
  align-items: center;
  gap: .25rem;
  min-height: 2.75rem;
  padding: 0 .75rem 0 .375rem;
  border: 0;
  border-radius: var(--cz-border-radius);
  background: var(--cz-tertiary-bg);
  color: var(--cz-heading-color);
  font-size: .875rem;
  font-weight: 500;
  white-space: nowrap;
}
.help-drawer__body {
  flex: 1 1 auto;
  overflow-y: auto;
  padding: 1.25rem;
}
.help-drawer__foot {
  border-top: 1px solid var(--cz-border-color);
  padding: .875rem 1.25rem calc(.875rem + env(safe-area-inset-bottom, 0px));
  display: flex;
  gap: .5rem;
  flex-wrap: wrap;
}

.help-answer {
  font-size: 1rem;
  color: var(--cz-heading-color);
  line-height: 1.5;
  margin-bottom: 1rem;
}
.help-section-label {
  font-size: .75rem;
  letter-spacing: .06em;
  text-transform: uppercase;
  font-weight: 600;
  color: var(--cz-secondary-color);
  margin: 1.5rem 0 .625rem;
}

/* Deadline / payment callout */
.help-callout {
  display: grid;
  grid-template-columns: auto 1fr;
  gap: .25rem .75rem;
  padding: .875rem 1rem;
  border-radius: var(--cz-border-radius-lg);
  background: var(--cz-warning-bg-subtle, #fff5e6);
  color: var(--cz-warning-text-emphasis, #7a3e00);
  border: 1px solid var(--cz-warning-border-subtle, #fdd7a8);
  font-size: .875rem;
  line-height: 1.45;
}
.help-callout i { font-size: 1.25rem; grid-row: span 2; margin-top: .0625rem; }
.help-callout strong { display: block; font-size: .9375rem; }
.help-callout--info {
  background: var(--help-tint);
  color: var(--cz-heading-color);
  border-color: var(--cz-border-color);
}

/* Numbered steps — the circle matches the order-form step circle */
.help-steps { list-style: none; margin: 0; padding: 0; display: grid; gap: .875rem; }
.help-steps > li { display: grid; grid-template-columns: 1.75rem 1fr; gap: .75rem; align-items: start; }
.help-step-num {
  width: 1.75rem;
  height: 1.75rem;
  border-radius: 50%;
  display: grid;
  place-items: center;
  font-size: .8125rem;
  font-weight: 600;
  background: var(--help-accent);
  color: var(--help-on-accent);
}
.help-steps p { margin: 0; color: var(--cz-body-color); line-height: 1.5; }
.help-steps strong { color: var(--cz-heading-color); }
.help-showme {
  display: inline-flex;
  align-items: center;
  gap: .3rem;
  margin-top: .375rem;
  min-height: 2.25rem;
  padding: 0 .625rem;
  border-radius: 999px;
  border: 1px solid var(--help-accent-text);
  background: transparent;
  color: var(--help-accent-text);
  font-size: .8125rem;
  font-weight: 600;
}
.help-showme:hover { background: var(--help-tint); }

/* Disclosure: "If this happens" */
.help-details { border-top: 1px solid var(--cz-border-color); }
.help-details:last-of-type { border-bottom: 1px solid var(--cz-border-color); }
.help-details summary {
  list-style: none;
  cursor: pointer;
  display: flex;
  align-items: center;
  gap: .5rem;
  min-height: 2.75rem;
  padding: .5rem 0;
  font-weight: 500;
  color: var(--cz-heading-color);
}
.help-details summary::-webkit-details-marker { display: none; }
.help-details summary::after {
  content: "\203A";
  margin-left: auto;
  font-size: 1.25rem;
  transition: transform .15s;
}
.help-details[open] summary::after { transform: rotate(90deg); }
.help-details > div { padding: 0 0 .875rem; font-size: .875rem; line-height: 1.5; }

/* Related links and result rows */
.help-links { list-style: none; margin: 0; padding: 0; }
.help-links a,
.help-result {
  display: flex;
  align-items: center;
  gap: .625rem;
  min-height: 2.75rem;
  padding: .5rem 0;
  color: var(--cz-heading-color);
  text-decoration: none;
  border-bottom: 1px solid var(--cz-border-color);
}
.help-links a:hover { color: var(--help-accent-text); }
.help-links i { color: var(--help-accent-text); }
.help-result { display: block; padding: .75rem 0; }
.help-result__title { font-weight: 600; color: var(--cz-heading-color); }
.help-result__meta { font-size: .75rem; color: var(--cz-secondary-color); margin-top: .125rem; }
.help-result__snippet { font-size: .875rem; margin-top: .25rem; color: var(--cz-body-color); }
mark.help-hit {
  background: var(--help-tint);
  color: var(--cz-heading-color);
  box-shadow: inset 0 -2px 0 var(--help-accent-text);
  padding: 0 .1em;
  border-radius: 2px;
}
.help-audience {
  display: inline-block;
  font-size: .6875rem;
  font-weight: 600;
  letter-spacing: .04em;
  text-transform: uppercase;
  padding: .125rem .5rem;
  border-radius: 999px;
  background: var(--cz-secondary-bg);
  color: var(--cz-heading-color);
}

/* ---------- Live UI elements (non-interactive examples) ---------- */
.help-ui {
  pointer-events: none;
  user-select: none;
  vertical-align: baseline;
}
.help-ui.btn {
  --cz-btn-padding-y: .1875rem;
  --cz-btn-padding-x: .625rem;
  --cz-btn-font-size: .8125rem;
  --cz-btn-border-radius: var(--cz-border-radius);
  margin: 0 .125rem;
}
.help-ui.btn-primary {
  --cz-btn-color: var(--help-on-accent);
  --cz-btn-bg: var(--help-accent);
  --cz-btn-border-color: var(--help-accent);
}
.help-ui-status {
  display: inline-block;
  font-size: .75rem;
  font-weight: 600;
  padding: .125rem .5rem;
  border-radius: 999px;
  vertical-align: baseline;
}
.help-ui-icon {
  display: inline-grid;
  place-items: center;
  width: 1.75rem;
  height: 1.75rem;
  border-radius: 50%;
  border: 1px solid var(--cz-border-color);
  color: var(--cz-heading-color);
  vertical-align: middle;
  font-size: .9375rem;
}
.help-ui-field {
  display: inline-block;
  font-size: .8125rem;
  font-weight: 500;
  padding: .0625rem .5rem;
  border: 1px dashed var(--cz-border-color);
  border-radius: var(--cz-border-radius-sm, .375rem);
  color: var(--cz-heading-color);
}

/* ---------- Show me ---------- */
.help-target-active {
  position: relative;
  z-index: 1060;
  outline: 3px solid var(--help-focus);
  outline-offset: 4px;
  border-radius: var(--cz-border-radius);
  animation: help-pulse 1.4s ease-out 2;
}
@keyframes help-pulse {
  0% { box-shadow: 0 0 0 0 rgba(var(--help-rgb), .55); }
  100% { box-shadow: 0 0 0 16px rgba(var(--help-rgb), 0); }
}
@media (prefers-reduced-motion: reduce) {
  .help-target-active { animation: none; }
}
.help-showme-bar {
  position: fixed;
  left: 50%;
  bottom: calc(1rem + env(safe-area-inset-bottom, 0px));
  transform: translateX(-50%);
  z-index: 1070;
  display: flex;
  align-items: center;
  gap: .75rem;
  max-width: calc(100% - 2rem);
  padding: .625rem .625rem .625rem 1rem;
  border-radius: 999px;
  background: var(--cz-emphasis-color, #181d25);
  color: var(--cz-body-bg);
  box-shadow: 0 8px 24px rgba(0,0,0,.25);
  font-size: .875rem;
}
.help-showme-bar button {
  min-height: 2.5rem;
  border-radius: 999px;
  border: 0;
  padding: 0 .875rem;
  background: var(--cz-body-bg);
  color: var(--cz-heading-color);
  font-weight: 600;
  white-space: nowrap;
}

/* ---------- Manual pages ---------- */
.help-page { padding-block: 2rem 4rem; }
.help-hero {
  background: var(--help-tint);
  border-radius: var(--cz-border-radius-xl);
  padding: 2rem 1.5rem;
}
.help-hero h1 { text-wrap: balance; }
.help-search-lg { position: relative; max-width: 40rem; }
.help-search-lg .form-control { min-height: 3.25rem; padding-left: 3rem; }
.help-search-lg i { position: absolute; left: 1.125rem; top: 50%; transform: translateY(-50%); font-size: 1.125rem; }
.help-cat {
  display: flex;
  gap: 1rem;
  align-items: flex-start;
  padding: 1.25rem;
  height: 100%;
  border: 1px solid var(--cz-border-color);
  border-radius: var(--cz-border-radius-lg);
  color: inherit;
  text-decoration: none;
  background: var(--cz-body-bg);
}
.help-cat:hover { border-color: var(--help-accent-text); }
.help-cat__icon {
  flex: none;
  width: 2.75rem;
  height: 2.75rem;
  border-radius: var(--cz-border-radius);
  display: grid;
  place-items: center;
  font-size: 1.25rem;
  background: var(--help-tint);
  color: var(--help-accent-text);
}
.help-cat__title { display: block; font-size: 1rem; font-weight: 600; color: var(--cz-heading-color); margin: 0 0 .25rem; }
.help-cat__blurb { display: block; font-size: .875rem; margin: 0 0 .25rem; }
.help-popular { display: flex; flex-wrap: wrap; gap: .5rem; }
.help-popular a {
  display: inline-flex;
  align-items: center;
  min-height: 2.75rem;
  padding: 0 1rem;
  border-radius: 999px;
  border: 1px solid var(--cz-border-color);
  color: var(--cz-heading-color);
  text-decoration: none;
  font-size: .875rem;
  font-weight: 500;
  background: var(--cz-body-bg);
}
.help-popular a:hover { border-color: var(--help-accent-text); color: var(--help-accent-text); }

/* Article page: one centred block, with the contents list beside the article on large screens. */
.help-layout {
  display: grid;
  grid-template-columns: minmax(0, 1fr);
  column-gap: 3rem;
  max-width: var(--help-measure);
  margin-inline: auto;
}
.help-layout__crumbs { grid-column: 1 / -1; }
@media (min-width: 992px) {
  .help-layout--toc {
    grid-template-columns: minmax(0, var(--help-measure)) var(--help-toc-width);
    max-width: calc(var(--help-measure) + var(--help-toc-width) + 3rem);
  }
}
.help-article h1 { text-wrap: balance; }
.help-article h2 { font-size: 1.25rem; margin-top: 2.25rem; scroll-margin-top: 6rem; }
.help-article p, .help-article li { line-height: 1.65; }
.help-article .help-steps p { font-size: 1rem; }
.help-question { font-size: .875rem; font-weight: 600; color: var(--help-accent-text); margin-bottom: .25rem; }
.help-toc {
  position: sticky;
  top: 6rem;
  font-size: .875rem;
  border-left: 2px solid var(--cz-border-color);
  padding-left: 1rem;
}
.help-toc a { display: block; padding: .3rem 0; color: var(--cz-body-color); text-decoration: none; }
.help-toc a:hover, .help-toc a[aria-current] { color: var(--help-accent-text); }
.help-diagram { border: 1px solid var(--cz-border-color); border-radius: var(--cz-border-radius-lg); padding: 1rem; background: var(--cz-body-bg); }
.help-diagram svg { display: block; width: 100%; height: auto; font-family: inherit; }
.help-diagram .hd-frame { fill: var(--cz-body-bg); stroke: var(--cz-border-color); }
.help-diagram .hd-block { fill: var(--cz-secondary-bg); }
.help-diagram .hd-muted { fill: var(--cz-tertiary-bg); }
.help-diagram .hd-outline { fill: none; stroke: var(--cz-border-color); stroke-dasharray: 4 4; }
.help-diagram .hd-input { fill: var(--cz-body-bg); stroke: var(--cz-border-color); }
.help-diagram .hd-highlight { fill: var(--help-tint); stroke: var(--help-accent-text); stroke-width: 2; }
.help-diagram .hd-accent { fill: var(--help-accent); }
.help-diagram .hd-danger { fill: var(--cz-danger, #f03d3d); }
.help-diagram .hd-text { fill: var(--cz-body-color); font-size: 12px; }
.help-diagram .hd-strong { font-weight: 600; font-size: 13px; }
.help-diagram .hd-on-accent { fill: var(--help-on-accent); font-size: 13px; }
.help-diagram .hd-on-danger { fill: #fff; font-size: 13px; }
.help-diagram text.hd-strong:not(.hd-on-accent):not(.hd-on-danger) { fill: var(--cz-heading-color); }
.help-diagram figcaption { font-size: .8125rem; margin-top: .75rem; color: var(--cz-secondary-color); }
.help-empty { text-align: center; padding: 2.5rem 1rem; }
.help-empty i { font-size: 2rem; color: var(--help-accent-text); }

.help-btn-accent {
  --cz-btn-color: var(--help-on-accent);
  --cz-btn-bg: var(--help-accent);
  --cz-btn-border-color: var(--help-accent);
  --cz-btn-hover-color: var(--help-on-accent);
  --cz-btn-hover-bg: var(--help-accent);
  --cz-btn-hover-border-color: var(--help-accent);
  --cz-btn-active-color: var(--help-on-accent);
  --cz-btn-active-bg: var(--help-accent);
}
.help-btn-accent:hover { filter: brightness(.94); }

/* ---------- Production additions ---------- */
.help-narrow { max-width: var(--help-measure); margin-inline: auto; }
.help-body > :first-child { font-size: 1.125rem; color: var(--cz-heading-color); }
.help-page .help-showme { display: none; }            /* Show me only works in the drawer, on the page itself */
.help-showme-missing { display: block; font-size: .8125rem; color: var(--cz-secondary-color); margin-top: .25rem; }
.help-showing .offcanvas-backdrop { opacity: 0 !important; }
.help-drawer .help-links a, .help-page .help-links a { align-items: flex-start; }
.help-drawer .help-links i, .help-page .help-links i { margin-top: .2rem; }
.help-result { color: inherit; text-decoration: none; }
.help-result:hover .help-result__title { color: var(--help-accent-text); }
.help-result__title, .help-result__meta, .help-result__snippet { display: block; }
.help-trigger[aria-current="page"] { background: var(--help-tint); }

@media print {
  .help-page { padding-block: 0; }
  .help-details { break-inside: avoid; }
  .help-ui.btn, .badge { border: 1px solid currentColor; }
}