/* =============================================================================
   docs.css — documentation archive, hub, and article.
   Loaded async on the docs CPT (archive + singular). Tokens only. Mobile-first.
   Reuses globals: .pd-card, .pd-prose, .pd-breadcrumb, .pd-grid, .pd-badge,
   .pd-section-head, .pd-eyebrow, .pd-frame.
   ============================================================================= */

/* ----------------------------------------------------------- Search field --- */
.pd-docs-search {
  position: relative;
  display: flex;
  gap: var(--pd-space-2);
  max-width: 34rem;
  margin: var(--pd-space-8) auto 0;
}
.pd-docs-search > svg {
  position: absolute;
  left: 1rem;
  top: 50%;
  transform: translateY(-50%);
  color: var(--pd-on-dark-muted);
  pointer-events: none;
}
.pd-docs-search input[type="search"] {
  flex: 1;
  min-width: 0;
  padding: 0.9rem 1rem 0.9rem 2.8rem;
  border-radius: var(--pd-radius-pill);
  background: rgba(245, 246, 250, 0.06);
  border: 1px solid var(--pd-border-dark);
  color: var(--pd-on-dark);
}
.pd-docs-search input[type="search"]::placeholder { color: var(--pd-on-dark-muted); }
.pd-docs-search .pd-btn { flex: none; }

/* ============================================================ Archive index = */
.pd-docs-hublist { align-items: stretch; }
.pd-doc-hubcard {
  display: flex;
  flex-direction: column;
  gap: var(--pd-space-3);
  text-decoration: none;
  color: inherit;
}
.pd-doc-hubcard:hover { text-decoration: none; }
.pd-doc-hubcard__icon {
  display: inline-flex;
  width: 48px; height: 48px;
  align-items: center; justify-content: center;
  color: var(--pd-violet);
  background: rgba(194, 97, 252, 0.10);
  border-radius: var(--pd-radius-sm);
}
.pd-doc-hubcard__title { font-size: var(--pd-h3); }
.pd-doc-hubcard__meta {
  display: inline-flex; align-items: center; gap: .4rem;
  margin-top: auto; padding-top: var(--pd-space-3);
  color: var(--pd-violet); font-weight: 600; font-size: var(--pd-text-sm);
}
.pd-doc-hubcard__meta svg { transition: transform .15s ease; }
.pd-doc-hubcard:hover .pd-doc-hubcard__meta svg { transform: translateX(4px); }

/* ================================================================ Hub hero == */
.pd-docs-meta {
  display: flex; flex-wrap: wrap;
  gap: var(--pd-space-2) var(--pd-space-6);
  justify-content: center;
  margin-top: var(--pd-space-6);
  color: var(--pd-on-dark-muted);
  font-size: var(--pd-text-sm);
}
.pd-docs-meta span { display: inline-flex; align-items: center; gap: .4rem; }
.pd-docs-meta svg { color: var(--pd-violet); }

/* ============================================================== Quick start = */
.pd-quickstart {
  background: linear-gradient(135deg, rgba(112, 97, 175, 0.20), rgba(194, 97, 252, 0.10));
  border-color: rgba(194, 97, 252, 0.25);
}
.pd-quickstart h2 { margin: var(--pd-space-2) 0 var(--pd-space-3); }
.pd-quickstart__steps {
  list-style: none; margin: var(--pd-space-6) 0; padding: 0;
  display: grid; gap: var(--pd-space-3);
}
.pd-quickstart__steps li {
  display: flex; align-items: center; gap: .6rem;
  font-weight: 600; font-size: var(--pd-text-sm);
}
.pd-quickstart__steps span {
  display: inline-flex; flex: none;
  width: 28px; height: 28px;
  align-items: center; justify-content: center;
  border-radius: var(--pd-radius-pill);
  background: var(--pd-grad-brand);
  color: var(--pd-white);
  font-size: var(--pd-text-xs); font-weight: 700;
}

/* ============================================================== Categories == */
.pd-doc-cat { display: flex; flex-direction: column; }
.pd-doc-cat__icon {
  display: inline-flex;
  width: 48px; height: 48px;
  align-items: center; justify-content: center;
  color: var(--pd-violet);
  background: rgba(194, 97, 252, 0.10);
  border-radius: var(--pd-radius-sm);
  margin-bottom: var(--pd-space-4);
}
.pd-doc-cat__title { font-size: var(--pd-h3); margin-bottom: var(--pd-space-2); }
.pd-doc-cat__desc { font-size: var(--pd-text-sm); margin-bottom: var(--pd-space-4); }
.pd-doc-cat__list { list-style: none; margin: 0; padding: 0; display: grid; gap: var(--pd-space-2); }
.pd-doc-cat__list a {
  display: flex; align-items: center; gap: .5rem;
  color: var(--pd-on-light); font-size: var(--pd-text-sm);
}
.pd-doc-cat__list a:hover { color: var(--pd-purple); text-decoration: none; }
.pd-doc-cat__list svg { color: var(--pd-violet); flex: none; }

/* =================================================================== Video == */
.pd-docs-video__frame { aspect-ratio: 16 / 9; }
.pd-docs-video__frame iframe { width: 100%; height: 100%; border: 0; display: block; }

/* ================================================================ Support === */
.pd-doc-support {
  display: flex; flex-direction: column; align-items: center;
  text-align: center; text-decoration: none; color: inherit;
}
.pd-doc-support:hover { text-decoration: none; }
.pd-doc-support__icon {
  display: inline-flex;
  width: 52px; height: 52px;
  align-items: center; justify-content: center;
  color: var(--pd-white);
  background: var(--pd-grad-brand);
  border-radius: var(--pd-radius);
  margin-bottom: var(--pd-space-4);
}
.pd-doc-support__title { font-size: var(--pd-h3); margin-bottom: var(--pd-space-2); }

/* ============================================================= Article view = */
.pd-breadcrumb--left { justify-content: flex-start; text-align: left; }

.pd-doc-layout { display: block; }
.pd-doc-main { min-width: 0; }

/* On-this-page TOC — off-canvas on mobile, sticky rail on desktop. */
.pd-doc-toc {
  position: fixed;
  left: var(--pd-space-4);
  right: var(--pd-space-4);
  bottom: 84px;
  z-index: 95;
  max-height: 60vh;
  overflow-y: auto;
  padding: var(--pd-space-6);
  background: var(--pd-surface-1);
  border: 1px solid var(--pd-border-dark);
  border-radius: var(--pd-radius);
  box-shadow: var(--pd-shadow-card);
  opacity: 0;
  visibility: hidden;
  transform: translateY(12px);
  transition: opacity .2s ease, transform .2s ease, visibility .2s;
}
.pd-doc-toc.is-open { opacity: 1; visibility: visible; transform: none; }
.pd-doc-toc__title {
  font-size: var(--pd-text-sm);
  text-transform: uppercase;
  letter-spacing: .08em;
  color: var(--pd-on-dark-muted);
  margin-bottom: var(--pd-space-3);
}
.pd-doc-toc ul { list-style: none; margin: 0; padding: 0; display: grid; gap: .1rem; border-left: 1px solid var(--pd-border-dark); }
.pd-doc-toc a {
  display: block;
  margin-left: -1px;
  padding: .35rem .85rem;
  border-left: 2px solid transparent;
  color: var(--pd-on-dark-muted);
  font-size: var(--pd-text-sm);
  line-height: 1.35;
}
.pd-doc-toc a:hover { color: var(--pd-starlight); text-decoration: none; }
.pd-doc-toc a.is-active { color: var(--pd-violet); border-left-color: var(--pd-violet); }
.pd-doc-toc__l3 a { padding-left: 1.6rem; font-size: var(--pd-text-xs); }

/* Floating toggle (mobile only). */
.pd-doc-toc-toggle {
  position: fixed;
  right: var(--pd-space-6);
  bottom: var(--pd-space-6);
  z-index: 96;
  width: 52px; height: 52px;
  display: inline-flex; align-items: center; justify-content: center;
  border-radius: var(--pd-radius-pill);
  background: var(--pd-grad-brand);
  color: var(--pd-white);
  box-shadow: var(--pd-glow-violet);
}
.pd-doc-toc-toggle svg { width: 24px; height: 24px; }

/* Article header + meta */
.pd-doc-head { margin-bottom: var(--pd-space-8); }
.pd-doc-head h1 { margin: var(--pd-space-3) 0 var(--pd-space-4); font-size: clamp(2rem, 1.4rem + 2.6vw, 2.85rem); }
.pd-doc-head .pd-badge { text-decoration: none; }
.pd-doc-head__meta {
  display: flex; flex-wrap: wrap;
  gap: var(--pd-space-2) var(--pd-space-6);
  color: var(--pd-on-dark-muted);
  font-size: var(--pd-text-sm);
}
.pd-doc-head__meta span { display: inline-flex; align-items: center; gap: .4rem; }
.pd-doc-head__meta svg { color: var(--pd-violet); }

/* Article body (extends .pd-prose) */
.pd-doc-body { max-width: 72ch; }
.pd-doc-body :where(h2, h3) { scroll-margin-top: calc(var(--pd-nav-h) + var(--pd-space-6)); }
.pd-doc-body :where(ul, ol) { padding-left: 1.25rem; }
.pd-doc-body li { margin-bottom: var(--pd-space-2); }
.pd-doc-body li::marker { color: var(--pd-violet); }

/* Prev / next */
.pd-doc-nav { display: grid; gap: var(--pd-space-4); margin-top: var(--pd-space-12); }
.pd-doc-nav__link {
  display: flex; flex-direction: column; gap: .25rem;
  padding: var(--pd-space-4) var(--pd-space-6);
  border: 1px solid var(--pd-border-dark);
  border-radius: var(--pd-radius);
  background: var(--pd-surface-1);
  transition: transform .15s ease, border-color .15s ease;
}
.pd-doc-nav__link:hover { transform: translateY(-2px); border-color: rgba(194, 97, 252, .4); text-decoration: none; }
.pd-doc-nav__next { text-align: right; align-items: flex-end; }
.pd-doc-nav__dir {
  display: inline-flex; align-items: center; gap: .35rem;
  font-size: var(--pd-text-xs); text-transform: uppercase; letter-spacing: .06em;
  color: var(--pd-on-dark-muted);
}
.pd-doc-nav__prev .pd-doc-nav__dir svg { transform: rotate(180deg); }
.pd-doc-nav__t { font-weight: 600; color: var(--pd-starlight); }

/* Contact card + related */
.pd-doc-help { margin-top: var(--pd-space-12); text-align: center; }
.pd-doc-help h2 { font-size: var(--pd-h3); margin-bottom: var(--pd-space-2); }
.pd-doc-help .pd-btn { margin-top: var(--pd-space-4); }
.pd-doc-related { margin-top: var(--pd-space-16); }
.pd-doc-related > h2 { font-size: var(--pd-h3); margin-bottom: var(--pd-space-6); }
.pd-doc-relcard { display: block; text-decoration: none; }
.pd-doc-relcard:hover { text-decoration: none; }
.pd-doc-relcard h3 { font-size: var(--pd-text-lg); margin-bottom: var(--pd-space-2); }
.pd-doc-relcard p { font-size: var(--pd-text-sm); }

/* --------------------------------------------------------------- Desktop --- */
@media (min-width: 640px) {
  .pd-quickstart__steps { grid-template-columns: repeat(2, 1fr); }
  .pd-doc-nav { grid-template-columns: 1fr 1fr; }
}

@media (min-width: 980px) {
  .pd-quickstart__steps { grid-template-columns: repeat(4, 1fr); }

  .pd-doc-layout {
    display: grid;
    grid-template-columns: 230px minmax(0, 1fr);
    gap: var(--pd-space-12);
    align-items: start;
  }

  /* TOC becomes a static sticky rail — undo the mobile off-canvas treatment. */
  .pd-doc-toc {
    position: sticky;
    top: calc(var(--pd-nav-h) + var(--pd-space-4));
    left: auto; right: auto; bottom: auto;
    z-index: auto;
    max-height: calc(100vh - var(--pd-nav-h) - var(--pd-space-8));
    padding: 0;
    background: transparent;
    border: 0;
    box-shadow: none;
    opacity: 1;
    visibility: visible;
    transform: none;
  }

  .pd-doc-toc-toggle { display: none; }
}

@media (prefers-reduced-motion: reduce) {
  .pd-doc-toc,
  .pd-doc-nav__link,
  .pd-doc-hubcard__meta svg { transition: none; }
}

/* ===================================================== Imported-doc prose === */
/* Primitives that appear only in imported articles: callouts (rebuilt from the
   live `info-box`), plus code/pre/table/h4/h5 on the dark prose body. Tokens
   only; the article body renders inside .section--dark. */
.pd-doc-body h4 { font-size: var(--pd-text-lg); margin: var(--pd-space-6) 0 var(--pd-space-2); color: var(--pd-starlight); }
.pd-doc-body h5 { font-size: var(--pd-text-sm); text-transform: uppercase; letter-spacing: .05em; margin: var(--pd-space-4) 0 var(--pd-space-2); color: var(--pd-on-dark-muted); }

.pd-doc-body :not(pre) > code {
  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
  font-size: .88em; padding: .12em .4em;
  border-radius: var(--pd-radius-sm);
  background: var(--pd-surface-2); border: 1px solid var(--pd-border-dark);
  color: var(--pd-starlight);
}
.pd-doc-body pre {
  margin: var(--pd-space-4) 0; padding: var(--pd-space-4);
  overflow-x: auto; border-radius: var(--pd-radius);
  background: var(--pd-surface-2); border: 1px solid var(--pd-border-dark);
}
.pd-doc-body pre code { padding: 0; border: 0; background: none; color: var(--pd-on-dark); }

.pd-doc-body table { width: 100%; border-collapse: collapse; margin: var(--pd-space-4) 0; font-size: var(--pd-text-sm); }
.pd-doc-body :where(th, td) { padding: var(--pd-space-2) var(--pd-space-3); border: 1px solid var(--pd-border-dark); text-align: left; }
.pd-doc-body thead th { background: var(--pd-surface-2); color: var(--pd-on-dark); }

.pd-callout {
  margin: var(--pd-space-6) 0; padding: var(--pd-space-4) var(--pd-space-6);
  border-radius: var(--pd-radius);
  background: var(--pd-surface-1); border: 1px solid var(--pd-border-dark);
  border-left: 3px solid var(--pd-violet);
}
.pd-callout__title { display: flex; align-items: center; gap: .4rem; margin: 0 0 var(--pd-space-2); font-weight: 700; color: var(--pd-starlight); }
.pd-callout > :last-child { margin-bottom: 0; }
.pd-callout--success { border-left-color: var(--pd-success); }
.pd-callout--warning { border-left-color: var(--pd-warning); }
.pd-callout--danger  { border-left-color: var(--pd-danger); }

/* ================================================== Docs search results ===== */
/* Tighten the gap under the hero — the results band follows a tall page hero. */
.pd-docs-searchresults { padding-top: var(--pd-space-8); }

.pd-docs-results {
  display: grid; gap: var(--pd-space-6);
  grid-template-columns: 1fr;
}

.pd-doc-result {
  display: flex; flex-direction: column; align-items: flex-start;
  gap: var(--pd-space-3); height: 100%;
  text-decoration: none; color: inherit;
  transition: transform .15s ease, border-color .15s ease;
}
.pd-doc-result:hover { transform: translateY(-3px); border-color: rgba(194, 97, 252, .4); text-decoration: none; }

.pd-doc-result__top {
  display: flex; align-items: center; justify-content: space-between;
  gap: var(--pd-space-3); width: 100%;
}
.pd-doc-result__icon {
  display: inline-flex; flex: none;
  width: 44px; height: 44px;
  align-items: center; justify-content: center;
  color: var(--pd-white);
  background: var(--pd-grad-brand);
  border-radius: var(--pd-radius-sm);
}
.pd-doc-result__section { text-decoration: none; }
.pd-doc-result__title { font-size: var(--pd-text-lg); color: var(--pd-starlight); }
.pd-doc-result__excerpt { font-size: var(--pd-text-sm); }

/* Search-term highlight in the excerpt. */
.pd-hl {
  background: rgba(194, 97, 252, .28);
  color: var(--pd-starlight);
  padding: 0 .15em; border-radius: var(--pd-radius-sm);
}

.pd-doc-result__meta {
  display: flex; flex-wrap: wrap; gap: var(--pd-space-2) var(--pd-space-6);
  margin-top: auto; padding-top: var(--pd-space-2);
  color: var(--pd-on-dark-muted); font-size: var(--pd-text-sm);
}
.pd-doc-result__meta > span { display: inline-flex; align-items: center; gap: .4rem; }
.pd-doc-result__meta svg { color: var(--pd-violet); flex: none; }

.pd-docs-noresults { max-width: 46ch; margin-inline: auto; }
.pd-docs-noresults .pd-lead { margin-bottom: var(--pd-space-2); }

/* 1 col (mobile) → 2 (tablet) → 3 (desktop). */
@media (min-width: 640px) { .pd-docs-results { grid-template-columns: repeat(2, 1fr); } }
@media (min-width: 960px) { .pd-docs-results { grid-template-columns: repeat(3, 1fr); } }

@media (prefers-reduced-motion: reduce) {
  .pd-doc-result { transition: none; }
}