/* Kinetic Docs — shared styles for /docs (user) and /docs/dev (developer).
   Consumes the canonical Kinetic Design System tokens from
   /shared/design-system.css ("Forward Motion" v2.0): semantic colours,
   Poppins typography, radius + spacing scales, light & dark themes.
   No hardcoded colours or ad-hoc fonts in this file. */

body {
  font-family: var(--font-body);
  background: var(--color-background);
  color: var(--color-on-background);
  line-height: 1.65;
}

/* ── Top bar ── */
.docs-topbar {
  background: var(--color-surface-container-lowest);
  border-bottom: 1px solid var(--color-outline-variant);
  padding: 0.75rem var(--space-gutter);
  display: flex;
  align-items: center;
  gap: var(--space-md);
  position: sticky;
  top: 0;
  z-index: 10;
  min-height: 56px;
}
.docs-brand {
  font-family: var(--font-display);
  font-weight: 800;
  font-size: 1.125rem;
  color: var(--color-on-surface);
  text-decoration: none;
  white-space: nowrap;
}
.docs-brand span {
  color: var(--color-primary);
}
.docs-audience {
  display: flex;
  gap: var(--space-sm);
  margin-left: auto;
}
.docs-audience a {
  text-decoration: none;
  color: var(--color-on-surface-variant);
  font-size: 0.875rem;
  font-weight: 600;
  padding: 0.5rem 1rem;
  border-radius: var(--radius-full);
  border: 1px solid transparent;
  transition:
    color 150ms ease,
    background-color 150ms ease;
}
.docs-audience a:hover {
  color: var(--color-primary);
}
.docs-audience a.active {
  background: var(--color-primary-container);
  color: var(--color-on-primary-container);
}

/* ── Layout ── */
.docs-layout {
  display: grid;
  grid-template-columns: 260px minmax(0, 1fr);
  gap: 2.5rem;
  max-width: 1200px;
  margin: 0 auto;
  padding: 2rem var(--space-gutter) 4rem;
}
@media (max-width: 900px) {
  .docs-layout {
    grid-template-columns: 1fr;
    gap: var(--space-lg);
    padding: 1rem var(--space-margin) 3rem; /* --space-margin drops to 16px on mobile via design-system.css */
  }
}

/* ── Sidebar ── */
.docs-sidebar {
  position: sticky;
  top: 4.25rem;
  align-self: start;
  font-size: 0.9rem;
}
.docs-sidebar .section {
  font-size: 0.75rem;
  font-weight: 700;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--color-on-surface-variant);
  margin: 1.25rem 0 0.375rem;
}
.docs-sidebar .section:first-child {
  margin-top: 0;
}
.docs-sidebar a {
  display: block;
  color: var(--color-on-surface);
  text-decoration: none;
  padding: 0.6rem 0.75rem; /* ≥40px tap target on mobile */
  border-left: 3px solid var(--color-outline-variant);
  overflow-wrap: anywhere;
  transition:
    border-color 150ms ease,
    color 150ms ease,
    background-color 150ms ease;
}
.docs-sidebar a:hover {
  border-left-color: var(--color-primary);
  color: var(--color-primary);
  background: color-mix(in srgb, var(--color-primary) 8%, transparent);
}
.docs-sidebar a.current {
  border-left-color: var(--color-primary);
  color: var(--color-primary);
  font-weight: 600;
  background: color-mix(in srgb, var(--color-primary) 10%, transparent);
}
@media (max-width: 900px) {
  .docs-sidebar {
    position: static;
    padding-bottom: var(--space-md);
    border-bottom: 1px solid var(--color-outline-variant);
  }
}

/* ── Main content ── */
.docs-main {
  min-width: 0;
}
.docs-main h1 {
  font-family: var(--font-display);
  font-size: 2rem;
  line-height: 1.25;
  letter-spacing: -0.01em;
  color: var(--color-on-surface);
  margin: 0 0 0.5rem;
}
.docs-main h2 {
  font-family: var(--font-display);
  font-size: 1.35rem;
  color: var(--color-on-surface);
  margin-top: 2.5rem;
  padding-bottom: 0.35rem;
  border-bottom: 1px solid var(--color-outline-variant);
}
.docs-main h3 {
  font-family: var(--font-display);
  font-size: 1.05rem;
  color: var(--color-on-surface);
  margin-top: 1.75rem;
}
.lead {
  font-size: 1.075rem;
  color: var(--color-on-surface-variant);
}
a {
  color: var(--color-primary);
}
p,
li,
td,
th {
  overflow-wrap: break-word;
}

/* ── Code ── */
code {
  font-family: var(--font-mono);
  background: color-mix(in srgb, var(--color-primary) 10%, transparent);
  color: var(--color-on-primary-fixed-variant);
  padding: 0.125em 0.4em;
  border-radius: var(--radius-md);
  font-size: 0.875em;
}
.dark code,
[data-theme='dark'] code {
  color: var(--color-primary-fixed-dim);
}
pre {
  font-family: var(--font-mono);
  background: var(--color-inverse-surface);
  color: var(--color-inverse-on-surface);
  padding: 1rem 1.25rem;
  border-radius: var(--radius-lg);
  overflow-x: auto;
  -webkit-overflow-scrolling: touch;
  font-size: 0.85rem;
  line-height: 1.55;
  max-width: 100%;
}
pre code {
  background: none;
  color: inherit;
  padding: 0;
  overflow-wrap: normal;
}

/* ── Callouts ── */
.callout {
  border-left: 4px solid var(--color-primary);
  background: color-mix(in srgb, var(--color-primary) 8%, transparent);
  border-radius: 0 var(--radius-lg) var(--radius-lg) 0;
  padding: 0.875rem 1.125rem;
  margin: 1.25rem 0;
  font-size: 0.95rem;
}
.callout.warning {
  border-left-color: var(--color-warning);
  background: var(--color-warning-container);
  color: var(--color-on-warning-container);
}
.callout.success {
  border-left-color: var(--color-success);
  background: var(--color-success-container);
  color: var(--color-on-success-container);
}

/* ── Steps ── */
.steps {
  counter-reset: step;
  list-style: none;
  padding: 0;
}
.steps > li {
  counter-increment: step;
  position: relative;
  padding-left: 2.6rem;
  margin-bottom: 1.1rem;
}
.steps > li::before {
  content: counter(step);
  position: absolute;
  left: 0;
  top: 0.1rem;
  width: 1.75rem;
  height: 1.75rem;
  border-radius: var(--radius-full);
  background: var(--color-primary);
  color: var(--color-on-primary);
  font-size: 0.85rem;
  font-weight: 700;
  display: flex;
  align-items: center;
  justify-content: center;
}

/* ── Cards ── */
.card-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
  gap: 1rem;
  margin: 1.5rem 0;
}
@media (max-width: 560px) {
  .card-grid {
    grid-template-columns: 1fr; /* single column so cards never squeeze below legibility */
  }
}
.doc-card {
  background: var(--color-surface-container-lowest);
  border: 1px solid var(--color-outline-variant);
  border-radius: var(--radius-xl);
  padding: 1.1rem 1.25rem;
  text-decoration: none;
  color: var(--color-on-surface);
  transition:
    border-color 150ms ease,
    box-shadow 150ms ease,
    transform 150ms ease;
}
.doc-card:hover {
  border-color: var(--color-primary);
  box-shadow: 0 4px 14px color-mix(in srgb, var(--color-primary) 18%, transparent);
  transform: translateY(-2px);
}
.doc-card:focus-visible {
  outline: 2px solid var(--color-primary);
  outline-offset: 2px;
}
.doc-card .kicker {
  font-size: 0.7rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--color-primary);
}
.doc-card strong {
  display: block;
  margin: 0.25rem 0;
  font-family: var(--font-display);
}
.doc-card p {
  margin: 0;
  font-size: 0.875rem;
  color: var(--color-on-surface-variant);
}

/* ── Tables ──
   display:block + horizontal scroll keeps wide API tables inside the
   viewport on mobile instead of stretching the page. */
table.doc-table {
  display: block;
  width: 100%;
  max-width: 100%;
  overflow-x: auto;
  -webkit-overflow-scrolling: touch;
  border-collapse: collapse;
  margin: 1.25rem 0;
  font-size: 0.92rem;
  background: var(--color-surface-container-lowest);
  border-radius: var(--radius-lg);
}
.doc-table th,
.doc-table td {
  text-align: left;
  padding: 0.6rem 0.875rem;
  border-bottom: 1px solid var(--color-outline-variant);
  vertical-align: top;
}
.doc-table th {
  background: var(--color-surface-container-high);
  color: var(--color-on-surface);
  font-size: 0.8rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  white-space: nowrap;
}

/* ── Pager ── */
.pager {
  display: flex;
  justify-content: space-between;
  flex-wrap: wrap;
  gap: var(--space-sm);
  margin-top: 3rem;
  padding-top: 1.25rem;
  border-top: 1px solid var(--color-outline-variant);
}
.pager a {
  text-decoration: none;
  font-weight: 600;
  padding: 0.5rem 0.75rem;
  min-height: 44px;
  display: inline-flex;
  align-items: center;
}

/* ── Footer ── */
footer.docs-footer {
  max-width: 1200px;
  margin: 0 auto;
  padding: 1.5rem var(--space-gutter);
  color: var(--color-on-surface-variant);
  font-size: 0.85rem;
  border-top: 1px solid var(--color-outline-variant);
}

/* ── Mobile refinements ── */
@media (max-width: 560px) {
  .docs-topbar {
    flex-wrap: wrap;
    row-gap: 0.5rem;
    padding: 0.625rem var(--space-margin); /* 16px */
  }
  .docs-audience a {
    padding: 0.5rem 0.875rem;
    min-height: 44px;
    display: inline-flex;
    align-items: center;
  }
  .docs-main h1 {
    font-size: 1.5rem; /* matches headline-lg-mobile scale */
  }
  pre {
    font-size: 0.78rem;
    padding: 0.875rem 1rem;
  }
  footer.docs-footer {
    padding-inline: var(--space-margin);
  }
}