/* ==========================================================================
   AppWithAI — "Build a CRM" guide
   Documentation layer for the Lunaris design system. Every value below is
   either a Lunaris token from style.css or derived from one; this file adds
   only the components a long-form technical guide needs and that the
   marketing pages do not have — chapter navigation, code blocks, figures,
   callouts, step lists and the screenshot lightbox.
   Load it after assets/css/style.css.
   ========================================================================== */

:root {
  --guide-sidebar-w: 288px;
  --guide-header-h: 73px;
  --guide-measure: 74ch;

  --guide-code-bg: #1a1a1f;
  --guide-code-text: #e8e8ec;
  --guide-code-dim: #8b8b96;
  --guide-code-key: #fbbf24;
  --guide-code-str: #86efac;
  --guide-code-num: #7dd3fc;
  --guide-code-kw: #f0abfc;
}

/* ---- layout ------------------------------------------------------------- */

.guide-shell {
  display: flex;
  align-items: flex-start;
  background: white;
}

.guide-sidebar {
  width: var(--guide-sidebar-w);
  flex: 0 0 var(--guide-sidebar-w);
  border-right: 1px solid var(--gray-200);
  background: var(--gray-50);
  padding: var(--spacing-xl) var(--spacing-md) var(--spacing-2xl);
  position: sticky;
  top: var(--guide-header-h);
  max-height: calc(100vh - var(--guide-header-h));
  overflow-y: auto;
}

.guide-eyebrow-label {
  font-size: var(--text-xs);
  font-weight: 700;
  letter-spacing: 0.09em;
  text-transform: uppercase;
  color: var(--gray-500);
  padding: 0 var(--spacing-sm);
}

.guide-sidebar-title {
  font-size: var(--text-lg);
  font-weight: 700;
  color: var(--gray-900);
  margin: var(--spacing-xs) 0 var(--spacing-lg);
  padding: 0 var(--spacing-sm);
  line-height: 1.3;
}

/* The chapter list is always open on desktop; on narrow screens it collapses
   behind its summary so a reader lands on the chapter, not on the index. */
.guide-toc-summary { display: none; }

.guide-toc-heading {
  font-size: var(--text-xs);
  font-weight: 700;
  letter-spacing: 0.09em;
  text-transform: uppercase;
  color: var(--gray-500);
  margin: var(--spacing-lg) 0 var(--spacing-sm);
  padding: 0 var(--spacing-sm);
}

.guide-nav {
  list-style: none;
  margin: 0;
  padding: 0;
}

.guide-nav li { margin: 2px 0; }

.guide-nav a {
  display: flex;
  align-items: baseline;
  gap: var(--spacing-sm);
  padding: 0.45rem var(--spacing-sm);
  border-radius: var(--radius-md);
  color: var(--gray-600);
  font-size: var(--text-sm);
  font-weight: 500;
  transition: all var(--transition-fast);
}

.guide-nav a:hover {
  background: var(--gray-100);
  color: var(--gray-900);
}

.guide-nav a[aria-current="page"] {
  background: white;
  color: var(--primary-700);
  font-weight: 600;
  box-shadow: var(--shadow-sm);
  border: 1px solid var(--primary-200);
}

.guide-num {
  font-variant-numeric: tabular-nums;
  font-size: var(--text-xs);
  font-weight: 600;
  color: var(--gray-400);
  min-width: 15px;
}

.guide-nav a[aria-current="page"] .guide-num { color: var(--primary-600); }

.guide-sidebar-foot {
  margin-top: var(--spacing-xl);
  padding: var(--spacing-md) var(--spacing-sm) 0;
  border-top: 1px solid var(--gray-200);
  font-size: var(--text-xs);
  line-height: 1.6;
  color: var(--gray-500);
}

.guide-main {
  flex: 1;
  min-width: 0;
  background: white;
}

.guide-content {
  max-width: 1000px;
  margin: 0 auto;
  padding: var(--spacing-2xl) var(--spacing-2xl) var(--spacing-4xl);
}

/* ---- typography --------------------------------------------------------- */

.guide-content .eyebrow {
  display: inline-block;
  font-size: var(--text-xs);
  font-weight: 700;
  letter-spacing: 0.09em;
  text-transform: uppercase;
  color: var(--primary-700);
  background: var(--primary-50);
  border: 1px solid var(--primary-100);
  padding: var(--spacing-xs) var(--spacing-md);
  border-radius: var(--radius-full);
  margin-bottom: var(--spacing-md);
}

.guide-content h1 {
  font-size: var(--text-4xl);
  line-height: 1.15;
  letter-spacing: -0.025em;
  margin-bottom: var(--spacing-md);
}

.guide-content h2 {
  font-size: var(--text-2xl);
  line-height: 1.25;
  letter-spacing: -0.015em;
  margin: var(--spacing-2xl) 0 var(--spacing-md);
  padding-top: var(--spacing-sm);
}

.guide-content h3 {
  font-size: var(--text-xl);
  margin: var(--spacing-xl) 0 var(--spacing-sm);
}

.guide-content h4 {
  font-size: var(--text-sm);
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--gray-500);
  margin: var(--spacing-lg) 0 var(--spacing-sm);
}

.guide-content .lede {
  font-size: var(--text-lg);
  line-height: 1.6;
  color: var(--gray-600);
  max-width: var(--guide-measure);
  margin-bottom: var(--spacing-sm);
}

.guide-content p,
.guide-content > ul,
.guide-content > ol {
  max-width: var(--guide-measure);
}

.guide-content p { margin-bottom: var(--spacing-md); }

.guide-content ul,
.guide-content ol {
  margin: 0 0 var(--spacing-md);
  padding-left: var(--spacing-lg);
}

.guide-content li { margin: var(--spacing-xs) 0; }

.guide-content code {
  font-family: var(--font-mono);
  font-size: 0.875em;
  background: var(--gray-100);
  border: 1px solid var(--gray-200);
  border-radius: var(--radius-sm);
  padding: 0.1em 0.35em;
  color: var(--gray-800);
}

.guide-content hr {
  border: 0;
  border-top: 1px solid var(--gray-200);
  margin: var(--spacing-2xl) 0;
}

/* ---- code blocks -------------------------------------------------------- */

.guide-content .code {
  background: var(--guide-code-bg);
  border-radius: var(--radius-lg);
  margin: var(--spacing-md) 0 var(--spacing-lg);
  overflow: hidden;
  box-shadow: var(--shadow-md);
}

.guide-content .code-head {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--spacing-md);
  padding: 0.6rem var(--spacing-md);
  background: rgba(255, 255, 255, 0.05);
  border-bottom: 1px solid rgba(255, 255, 255, 0.08);
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  color: var(--guide-code-dim);
}

.guide-content .code-head .tag {
  text-transform: uppercase;
  letter-spacing: 0.08em;
  font-size: 0.65rem;
  font-weight: 700;
  color: var(--guide-code-key);
}

.guide-content .code pre {
  margin: 0;
  padding: var(--spacing-md) var(--spacing-lg);
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: 0.8125rem;
  line-height: 1.65;
  color: var(--guide-code-text);
}

.guide-content .code pre code {
  background: none;
  border: 0;
  padding: 0;
  font-size: inherit;
  color: inherit;
}

.guide-content .c-com { color: var(--guide-code-dim); }
.guide-content .c-dir { color: var(--guide-code-key); }
.guide-content .c-str { color: var(--guide-code-str); }
.guide-content .c-num { color: var(--guide-code-num); }
.guide-content .c-kw  { color: var(--guide-code-kw); }

/* ---- figures ------------------------------------------------------------ */

.guide-content figure {
  margin: var(--spacing-lg) 0 var(--spacing-xl);
}

.guide-content figure img {
  display: block;
  width: 100%;
  height: auto;
  border: 1px solid var(--gray-200);
  border-radius: var(--radius-lg);
  background: white;
  box-shadow: var(--shadow-md);
  cursor: zoom-in;
}

/* The caption sits *above* its image: a reader should know what they are about
   to look at before they look at it, rather than scrolling past a screenshot
   and finding out afterwards what it was showing. */
.guide-content figcaption {
  margin-bottom: var(--spacing-sm);
  font-size: var(--text-sm);
  line-height: 1.55;
  color: var(--gray-500);
  max-width: var(--guide-measure);
}

.guide-content figcaption b {
  color: var(--gray-700);
  font-weight: 600;
}

.guide-content .fig-tall img {
  max-height: 620px;
  object-fit: cover;
  object-position: top;
}

.guide-content .fig-row {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--spacing-lg);
  margin: var(--spacing-lg) 0 var(--spacing-xl);
}

.guide-content .fig-row figure { margin: 0; }

/* ---- callouts ----------------------------------------------------------- */

.guide-content .note {
  border-left: 3px solid var(--primary-500);
  background: var(--primary-50);
  padding: var(--spacing-md) var(--spacing-lg);
  border-radius: 0 var(--radius-lg) var(--radius-lg) 0;
  margin: var(--spacing-lg) 0;
  max-width: var(--guide-measure);
}

.guide-content .note.tip  { border-left-color: var(--accent-500);  background: var(--accent-50); }
.guide-content .note.warn { border-left-color: var(--error-500);   background: var(--error-50); }
.guide-content .note.win  { border-left-color: var(--success-500); background: var(--success-50); }

.guide-content .note p:last-child { margin-bottom: 0; }

.guide-content .note-title {
  font-weight: 700;
  font-size: var(--text-xs);
  letter-spacing: 0.05em;
  text-transform: uppercase;
  margin-bottom: var(--spacing-xs);
  color: var(--gray-700);
}

/* ---- steps -------------------------------------------------------------- */

.guide-content .steps {
  counter-reset: step;
  list-style: none;
  padding: 0;
  margin: var(--spacing-lg) 0;
  max-width: var(--guide-measure);
}

.guide-content .steps > li {
  counter-increment: step;
  position: relative;
  padding: 0 0 var(--spacing-lg) var(--spacing-2xl);
  border-left: 2px solid var(--gray-200);
  margin-left: 15px;
}

.guide-content .steps > li:last-child {
  border-left-color: transparent;
  padding-bottom: 0;
}

.guide-content .steps > li::before {
  content: counter(step);
  position: absolute;
  left: -16px;
  top: -2px;
  width: 30px;
  height: 30px;
  border-radius: var(--radius-full);
  background: linear-gradient(135deg, var(--primary-500) 0%, var(--secondary-500) 100%);
  color: white;
  font-size: var(--text-sm);
  font-weight: 700;
  display: grid;
  place-items: center;
}

.guide-content .steps h3 {
  margin: 0 0 var(--spacing-xs);
  font-size: var(--text-lg);
}

/* ---- chapter cards ------------------------------------------------------ */

.guide-content .guide-cards {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
  gap: var(--spacing-md);
  margin: var(--spacing-lg) 0;
}

.guide-content .guide-card {
  display: block;
  color: inherit;
  background: white;
  border: 1px solid var(--gray-200);
  border-radius: var(--radius-xl);
  padding: var(--spacing-lg);
  box-shadow: var(--shadow-sm);
  transition: all var(--transition-base);
}

.guide-content a.guide-card:hover {
  border-color: var(--primary-300);
  box-shadow: var(--shadow-lg);
  transform: translateY(-2px);
}

.guide-content .guide-card-num {
  font-size: var(--text-xs);
  font-weight: 700;
  letter-spacing: 0.09em;
  color: var(--primary-600);
  text-transform: uppercase;
}

.guide-content .guide-card h3 {
  margin: var(--spacing-xs) 0;
  font-size: var(--text-lg);
  color: var(--gray-900);
}

.guide-content .guide-card p {
  margin: 0;
  font-size: var(--text-sm);
  color: var(--gray-600);
}

/* ---- tables ------------------------------------------------------------- */

.guide-content .table-wrap {
  overflow-x: auto;
  margin: var(--spacing-lg) 0;
  border: 1px solid var(--gray-200);
  border-radius: var(--radius-lg);
}

/* main.js wraps every table in its own scroller; neutralise the extra margin
   so the border-radius of .table-wrap still hugs the table. */
.guide-content .table-wrap > .table-wrapper { margin: 0 !important; }

.guide-content table {
  border-collapse: collapse;
  width: 100%;
  font-size: var(--text-sm);
  background: white;
}

.guide-content th,
.guide-content td {
  text-align: left;
  padding: 0.65rem var(--spacing-md);
  border-bottom: 1px solid var(--gray-200);
  vertical-align: top;
}

.guide-content th {
  background: var(--gray-50);
  font-size: var(--text-xs);
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--gray-500);
  font-weight: 700;
}

.guide-content tr:last-child td { border-bottom: 0; }

.guide-content td code { white-space: nowrap; }

/* ---- stats -------------------------------------------------------------- */

.guide-content .stats {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(122px, 1fr));
  gap: var(--spacing-md);
  margin: var(--spacing-lg) 0;
}

.guide-content .stat {
  background: white;
  border: 1px solid var(--gray-200);
  border-radius: var(--radius-lg);
  padding: var(--spacing-md) var(--spacing-lg);
}

.guide-content .stat .n {
  font-size: var(--text-3xl);
  font-weight: 800;
  line-height: 1.1;
  background: linear-gradient(135deg, var(--primary-600) 0%, var(--secondary-600) 100%);
  -webkit-background-clip: text;
  -webkit-text-fill-color: transparent;
  background-clip: text;
}

.guide-content .stat .l {
  font-size: var(--text-xs);
  color: var(--gray-500);
  margin-top: 2px;
}

/* ---- pager -------------------------------------------------------------- */

.guide-content .pager {
  display: flex;
  gap: var(--spacing-md);
  margin-top: var(--spacing-3xl);
  padding-top: var(--spacing-xl);
  border-top: 1px solid var(--gray-200);
}

.guide-content .pager a {
  flex: 1;
  color: inherit;
  border: 1px solid var(--gray-200);
  border-radius: var(--radius-lg);
  padding: var(--spacing-md) var(--spacing-lg);
  background: white;
  transition: all var(--transition-base);
}

.guide-content .pager a:hover {
  border-color: var(--primary-300);
  box-shadow: var(--shadow-md);
}

.guide-content .pager .dir {
  font-size: var(--text-xs);
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--gray-500);
}

.guide-content .pager .ttl {
  font-weight: 600;
  margin-top: 2px;
  color: var(--gray-900);
}

.guide-content .pager .next { text-align: right; }

/* ---- lightbox ----------------------------------------------------------- */

.lightbox {
  position: fixed;
  inset: 0;
  z-index: 2000;
  background: rgba(24, 24, 27, 0.92);
  display: none;
  place-items: center;
  padding: var(--spacing-xl);
  cursor: zoom-out;
}

.lightbox.open { display: grid; }

.lightbox img {
  max-width: 100%;
  max-height: 100%;
  border-radius: var(--radius-md);
  box-shadow: var(--shadow-2xl);
}

.lightbox-hint {
  position: fixed;
  bottom: var(--spacing-lg);
  left: 0;
  right: 0;
  text-align: center;
  color: var(--gray-400);
  font-size: var(--text-sm);
}

/* ---- responsive --------------------------------------------------------- */

@media (max-width: 1023px) {
  .guide-shell { display: block; }

  .guide-sidebar {
    width: auto;
    max-height: none;
    position: static;
    border-right: 0;
    border-bottom: 1px solid var(--gray-200);
    padding: var(--spacing-lg) var(--container-padding);
  }

  .guide-nav { display: flex; flex-wrap: wrap; gap: var(--spacing-xs); }
  .guide-nav a { padding: 0.4rem 0.7rem; }
  .guide-toc-heading { margin-top: var(--spacing-md); }
  .guide-sidebar-title,
  .guide-eyebrow-label,
  .guide-toc-heading { padding-left: 0; }
  .guide-sidebar-foot { padding-left: 0; }

  .guide-toc-summary {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: var(--spacing-sm);
    cursor: pointer;
    list-style: none;
    padding: 0.6rem var(--spacing-md);
    border: 1px solid var(--gray-200);
    border-radius: var(--radius-lg);
    background: white;
    font-size: var(--text-sm);
    font-weight: 600;
    color: var(--gray-900);
  }

  .guide-toc-summary::-webkit-details-marker { display: none; }

  .guide-toc-summary::after {
    content: '▾';
    color: var(--gray-500);
    font-size: var(--text-xs);
  }

  .guide-toc[open] .guide-toc-summary::after { content: '▴'; }

  .guide-toc-current {
    margin-left: auto;
    font-weight: 500;
    color: var(--primary-600);
    white-space: nowrap;
    overflow: hidden;
    text-overflow: ellipsis;
  }

  .guide-toc-body { padding-top: var(--spacing-md); }
  .guide-toc-body > .guide-toc-heading:first-child { margin-top: 0; }

  .guide-content { padding: var(--spacing-xl) var(--container-padding) var(--spacing-3xl); }
  .guide-content .fig-row { grid-template-columns: 1fr; }
}

@media (max-width: 767px) {
  .guide-content h1 { font-size: var(--text-3xl); }
  .guide-content h2 { font-size: var(--text-xl); }
  .guide-content h3 { font-size: var(--text-lg); }
  .guide-content .lede { font-size: var(--text-base); }
  .guide-content .pager { flex-direction: column; }
  .guide-content .pager .next { text-align: left; }
  .guide-content .code pre { font-size: 0.75rem; }
}

@media print {
  .header, .footer, .guide-sidebar, .guide-content .pager, .lightbox { display: none; }
  .guide-content { max-width: none; padding: 0; }
  .guide-content figure img { box-shadow: none; }
}