/* ══════════════════════════════════════════════════════════════
   Array HQ — Card & navigation components for MkDocs
   Visually aligned with Storybook CardContainer + ActionCard.
   All values bind to semantic tokens from tokens.css.

   Canonical source:
     packages/ui/src/components/CardContainer/CardContainer.variants.ts
     packages/ui/src/components/ActionCard/ActionCard.variants.ts
   ══════════════════════════════════════════════════════════════ */


/* ──────────────────────────────────────────────────────────────
   1. CARD GRID — hub-page card layouts (CardContainer parity)

   Markdown usage:
     <div class="card-grid" markdown>
       <a class="card" href="path/">
         <span class="card-title">Title</span>
         <span class="card-desc">Description</span>
       </a>
     </div>

   Storybook spec: rounded-xl (12px), p-5 (20px), bg → bg-hover transition
   ────────────────────────────────────────────────────────────── */

.card-grid {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: 0.75rem;
  margin: 1.5rem 0;
}

.card-grid.cols-3 { grid-template-columns: repeat(3, 1fr); }

.card-grid .card {
  display: flex;
  flex-direction: column;
  justify-content: center;
  padding: 1.25rem;                /* p-5 — Storybook */
  border-radius: 12px;             /* rounded-xl — Storybook */
  background-color: var(--color-semantic-card-container-bg);
  border: 1px solid var(--color-semantic-card-container-outline-border);
  text-decoration: none !important;
  color: var(--color-semantic-fg-primary) !important;
  transition: background-color 0.2s ease, border-color 0.2s ease, box-shadow 0.2s ease;
  min-height: 9.5rem;              /* fits a 3-line description + title + padding */
  position: relative;
}

.card-grid .card:hover {
  background-color: var(--color-semantic-card-container-bg-hover);
  border-color: var(--color-semantic-stroke-strong);
  box-shadow: var(--array-shadow-card);
}

/* Chevron */
.card-grid .card::after {
  content: "›";
  position: absolute;
  right: 1rem;
  top: 50%;
  transform: translateY(-50%);
  font-size: 1.5rem;
  font-weight: 300;
  color: var(--color-semantic-fg-muted);
  transition: color 0.2s ease, transform 0.2s ease;
}

.card-grid .card:hover::after {
  color: var(--color-semantic-accent-brand-primary);
  transform: translateY(-50%) translateX(2px);
}

.card-grid .card .card-title {
  font-weight: 600;
  font-size: 0.9rem;
  line-height: 1.4;
  margin-bottom: 0.25rem;
  padding-right: 1.5rem;
}

.card-grid .card .card-desc {
  font-size: 0.8rem;
  line-height: 1.5;
  color: var(--color-semantic-fg-muted);
  padding-right: 1.5rem;
}

.card-grid .card:not(:has(.card-desc)) {
  min-height: 4rem;
}

@media screen and (max-width: 768px) {
  .card-grid,
  .card-grid.cols-3 { grid-template-columns: 1fr; }
}


/* ──────────────────────────────────────────────────────────────
   2. ACTION CARD — single primary CTA per page section

   Markdown usage:
     <a class="action-card" href="path/">
       <span class="action-card-label">Read the overview →</span>
     </a>

   Storybook spec: rounded-[12px], p-[16px], gap-[24px], bg → bg-hover
   ────────────────────────────────────────────────────────────── */

.action-card {
  display: flex;
  flex-direction: column;
  align-items: flex-start;
  gap: 24px;
  width: 100%;
  padding: 16px;
  border-radius: 12px;
  background-color: var(--color-semantic-action-card-bg);
  border: 1px solid var(--color-semantic-action-card-border);
  text-decoration: none !important;
  color: var(--color-semantic-action-card-label) !important;
  cursor: pointer;
  transition: background-color 0.2s ease, border-color 0.2s ease;
  text-align: left;
  outline: none;
}

.action-card:hover,
.action-card:active {
  background-color: var(--color-semantic-action-card-bg-hover);
}

.action-card:focus-visible {
  box-shadow: 0 0 0 2px var(--color-semantic-action-card-label);
}

.action-card .action-card-label {
  font-size: 14px;
  line-height: 20px;
  color: var(--color-semantic-action-card-label);
}


/* ──────────────────────────────────────────────────────────────
   3. PREV / NEXT PAGE NAVIGATION
   ────────────────────────────────────────────────────────────── */

.page-nav {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 0.75rem;
  margin-top: 2.5rem;
  padding-top: 1.5rem;
  border-top: 1px solid var(--color-semantic-stroke-default);
}

.page-nav a {
  display: flex;
  flex-direction: column;
  padding: 1rem 1.25rem;
  border: 1px solid var(--color-semantic-card-container-outline-border);
  border-radius: 12px;
  background-color: var(--color-semantic-card-container-bg);
  text-decoration: none !important;
  color: var(--color-semantic-fg-primary) !important;
  transition: background-color 0.2s ease, border-color 0.2s ease;
  position: relative;
}

.page-nav a:hover {
  background-color: var(--color-semantic-card-container-bg-hover);
  border-color: var(--color-semantic-stroke-strong);
}

.page-nav-prev { text-align: left;  padding-left: 2.25rem !important; }
.page-nav-next { text-align: right; padding-right: 2.25rem !important; }

.page-nav-prev::before,
.page-nav-next::before {
  position: absolute;
  top: 50%;
  transform: translateY(-50%);
  font-size: 1.5rem;
  font-weight: 300;
  color: var(--color-semantic-fg-muted);
}
.page-nav-prev::before { content: "‹"; left: 0.75rem; }
.page-nav-next::before { content: "›"; right: 0.75rem; }

.page-nav-label {
  font-size: 0.7rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--color-semantic-fg-muted);
  margin-bottom: 0.15rem;
}

.page-nav-title {
  font-weight: 500;
  font-size: 0.9rem;
}

@media screen and (max-width: 768px) {
  .page-nav { grid-template-columns: 1fr; }
}


/* ──────────────────────────────────────────────────────────────
   4. BREADCRUMB BAR — BreadcrumbsBar parity

   Markdown:
     <nav class="breadcrumbs-bar" aria-label="Breadcrumb">
       <a href="../">Section</a>
       <span class="sep">/</span>
       <span class="current">Page</span>
     </nav>
   ────────────────────────────────────────────────────────────── */

.breadcrumbs-bar {
  display: flex;
  align-items: center;
  gap: 0.5rem;
  font-size: 0.75rem;
  letter-spacing: 0.02em;
  margin-bottom: 0.75rem;
}

.breadcrumbs-bar a {
  color: var(--color-semantic-fg-muted);
  text-decoration: none;
}
.breadcrumbs-bar a:hover { color: var(--color-semantic-accent-brand-primary); }

.breadcrumbs-bar .sep {
  color: var(--color-semantic-fg-muted);
  opacity: 0.6;
}

.breadcrumbs-bar .current {
  color: var(--color-semantic-fg-primary);
  font-weight: 500;
}


/* ──────────────────────────────────────────────────────────────
   5. FIGURE CAPTIONS
   ────────────────────────────────────────────────────────────── */

.md-typeset figure {
  margin: 1.5rem 0;
  text-align: center;
}

.md-typeset figure img {
  max-width: 100%;
  border-radius: var(--array-radius-md);
}

.md-typeset figcaption,
.md-typeset figure em,
.md-typeset .caption {
  display: block;
  text-align: center;
  font-style: italic;
  font-size: 0.8rem;
  color: var(--color-semantic-fg-muted);
  margin-top: 0.5rem;
}


/* ──────────────────────────────────────────────────────────────
   6. SECTION HEADER (sidebar group labels)
   ────────────────────────────────────────────────────────────── */

.md-nav__item--section > .md-nav__link {
  font-size: 0.7rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--color-semantic-fg-muted) !important;
  pointer-events: none;
}


/* ──────────────────────────────────────────────────────────────
   7. HOME HERO
   ────────────────────────────────────────────────────────────── */

.home-hero {
  text-align: center;
  padding: 2rem 0 1.5rem;
  margin-bottom: 1rem;
}

.home-hero h1 {
  font-size: 2.25rem;
  font-weight: 700;
  margin-bottom: 0.5rem;
  color: var(--color-semantic-fg-primary);
  letter-spacing: -0.01em;
}

.home-hero p {
  font-size: 1.05rem;
  color: var(--color-semantic-fg-secondary);
  max-width: 720px;
  margin: 0 auto;
  line-height: 1.55;
}


/* ──────────────────────────────────────────────────────────────
   8. LAST UPDATED TIMESTAMP
   ────────────────────────────────────────────────────────────── */

.last-updated {
  font-size: 0.75rem;
  color: var(--color-semantic-fg-muted);
  margin-top: 2rem;
  font-style: italic;
}