/* Documentation pages — Apple-inspired reading layout */

.doc-page {
  background: var(--void-soft);
  padding-top: var(--nav-height);
}

.doc-top-nav {
  position: fixed;
  top: 0;
  left: 0;
  right: 0;
  transform: none;
  border-radius: 0;
  border-bottom: 1px solid var(--line);
  padding-inline: max(1.25rem, calc((100vw - var(--wide-max)) / 2 + 1.25rem));
}

.doc-top-links {
  display: flex;
  align-items: center;
  gap: 0.25rem;
  margin-left: auto;
}

.doc-top-links a {
  padding: 0.35rem 0.65rem;
  font-size: 0.8125rem;
  color: var(--ink-muted);
  border-radius: 6px;
}

.doc-top-links a:hover,
.doc-top-links a.is-active {
  color: var(--ink);
}

.doc-layout {
  display: grid;
  grid-template-columns: 260px minmax(0, 1fr);
  gap: 2rem;
  padding-block: 2rem 3rem;
  align-items: start;
}

.doc-sidebar {
  position: sticky;
  top: calc(var(--nav-height) + 1rem);
  max-height: calc(100vh - var(--nav-height) - 2rem);
  overflow: auto;
  padding: 1rem;
  background: var(--void-card);
  border: 1px solid var(--line);
  border-radius: var(--radius);
}

.doc-sidebar-title {
  display: block;
  font-family: var(--font-display);
  font-weight: 600;
  font-size: 1rem;
  margin-bottom: 0.75rem;
  color: var(--ink);
}

.doc-nav-group + .doc-nav-group {
  margin-top: 1rem;
  padding-top: 1rem;
  border-top: 1px solid var(--line);
}

.doc-nav-label {
  margin: 0 0 0.35rem;
  font-size: 0.6875rem;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--ink-subtle);
}

.doc-sidebar a {
  display: block;
  padding: 0.35rem 0.5rem;
  font-size: 0.8125rem;
  color: var(--ink-muted);
  border-radius: 6px;
}

.doc-sidebar a:hover {
  color: var(--ink);
  background: var(--void-alt);
}

.doc-sidebar a.is-active {
  color: var(--apple-blue);
  background: var(--apple-blue-soft);
  font-weight: 600;
}

.doc-main {
  min-width: 0;
}

.doc-article {
  padding: 2rem 2.25rem;
  background: var(--void-card);
  border: 1px solid var(--line);
  border-radius: var(--radius);
  box-shadow: var(--shadow-sm);
}

.doc-article h1 {
  font-family: var(--font-display);
  font-size: clamp(1.75rem, 3vw, 2.25rem);
  font-weight: 600;
  letter-spacing: var(--tracking-headline);
  line-height: var(--leading-tight);
  margin: 0 0 1rem;
}

.doc-article h2 {
  font-family: var(--font-display);
  font-size: 1.375rem;
  font-weight: 600;
  margin: 2rem 0 0.75rem;
  padding-top: 0.5rem;
  border-top: 1px solid var(--line);
}

.doc-article h2:first-of-type {
  margin-top: 1.25rem;
  border-top: none;
  padding-top: 0;
}

.doc-article h3 {
  font-size: 1.0625rem;
  font-weight: 600;
  margin: 1.5rem 0 0.5rem;
}

.doc-article h4 {
  font-size: 0.9375rem;
  font-weight: 600;
  margin: 1.25rem 0 0.35rem;
}

.doc-article p,
.doc-article li {
  color: var(--ink-dim);
  font-size: 0.9375rem;
  line-height: 1.6;
}

.doc-article p {
  margin: 0 0 1rem;
}

.doc-article ul,
.doc-article ol {
  margin: 0 0 1rem 1.25rem;
  padding: 0;
}

.doc-article li {
  margin-bottom: 0.35rem;
}

.doc-article code {
  font-family: var(--font-mono);
  font-size: 0.85em;
  padding: 0.12em 0.35em;
  border-radius: 6px;
  background: var(--void-alt);
  color: var(--ink-dim);
}

.doc-article pre {
  margin: 0 0 1.25rem;
  padding: 1rem 1.125rem;
  overflow-x: auto;
  border-radius: var(--radius-sm);
  background: #1d1d1f;
  border: 1px solid rgba(0, 0, 0, 0.08);
}

.doc-article pre code {
  display: block;
  padding: 0;
  background: transparent;
  color: #f5f5f7;
  font-size: 0.8125rem;
  line-height: 1.55;
  white-space: pre;
}

.doc-table-wrap {
  overflow-x: auto;
  margin: 0 0 1.25rem;
}

.doc-article table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.875rem;
}

.doc-article th,
.doc-article td {
  padding: 0.65rem 0.75rem;
  border: 1px solid var(--line);
  text-align: left;
  vertical-align: top;
}

.doc-article th {
  background: var(--void-alt);
  font-weight: 600;
  color: var(--ink);
}

.doc-article a {
  color: var(--apple-blue);
  text-decoration: underline;
  text-underline-offset: 2px;
}

.doc-article hr {
  border: none;
  border-top: 1px solid var(--line);
  margin: 1.5rem 0;
}

.doc-footer {
  display: flex;
  justify-content: space-between;
  gap: 1rem;
  margin-top: 1.25rem;
  padding-top: 1rem;
  font-size: 0.875rem;
}

.doc-footer a {
  color: var(--apple-blue);
}

/* Docs hub (index) */
.doc-hub {
  padding-block: 2rem 3rem;
}

.doc-hub-head {
  max-width: 40rem;
  margin-bottom: 2.5rem;
}

.doc-hub-head h1 {
  font-family: var(--font-display);
  font-size: clamp(2rem, 4vw, 2.75rem);
  font-weight: 600;
  letter-spacing: var(--tracking-headline);
  line-height: var(--leading-tight);
  margin: 0 0 0.75rem;
}

.doc-hub-group {
  margin-bottom: 2rem;
}

.doc-hub-group h2 {
  font-family: var(--font-display);
  font-size: 1.125rem;
  font-weight: 600;
  margin: 0 0 0.75rem;
  color: var(--ink-muted);
}

.doc-hub-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
  gap: 0.75rem;
}

.doc-hub-card {
  display: flex;
  flex-direction: column;
  gap: 0.25rem;
  padding: 1rem 1.125rem;
  background: var(--void-card);
  border: 1px solid var(--line);
  border-radius: var(--radius-sm);
  transition: border-color 0.2s, box-shadow 0.2s;
}

.doc-hub-card:hover {
  border-color: var(--line-strong);
  box-shadow: var(--shadow-sm);
}

.doc-hub-card-title {
  font-weight: 600;
  color: var(--ink);
}

.doc-hub-card-meta {
  font-size: 0.75rem;
  color: var(--ink-subtle);
  font-family: var(--font-mono);
}

/* Docs section on marketing homepage */
.doc-catalog {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
  gap: 0.875rem;
}

.doc-catalog-group {
  margin-bottom: 2rem;
}

.doc-catalog-group h3 {
  font-family: var(--font-display);
  font-size: 1rem;
  font-weight: 600;
  color: var(--ink-muted);
  margin: 0 0 0.65rem;
}

.doc-catalog-card {
  display: flex;
  flex-direction: column;
  gap: 0.2rem;
  padding: 1rem 1.125rem;
  background: var(--void-card);
  border: 1px solid var(--line);
  border-radius: var(--radius-sm);
  transition: border-color 0.2s, box-shadow 0.2s;
}

.doc-catalog-card:hover {
  border-color: var(--apple-blue);
  box-shadow: var(--shadow-sm);
}

.doc-catalog-card strong {
  font-weight: 600;
  color: var(--ink);
}

.doc-catalog-card span {
  font-size: 0.75rem;
  color: var(--ink-subtle);
}

@media (max-width: 900px) {
  .doc-layout {
    grid-template-columns: 1fr;
  }

  .doc-sidebar {
    position: static;
    max-height: none;
  }

  .doc-article {
    padding: 1.25rem 1rem;
  }
}

@media (max-width: 768px) {
  .doc-top-links a:not(.is-active) {
    display: none;
  }
}