/* api-docs.css — CloudPromo API docs section ("Sidebar fija", ux.md Opción A). */
/* Reuses tokens from tokens-palette-dark.css; no new palette. */
/* This sheet is only linked on /documentacion-api/, so the `html` selector below is scoped in effect. */

html {
  scroll-behavior: smooth;
}

.api-docs-layout {
  display: grid;
  grid-template-columns: 260px 1fr;
  gap: var(--space-8);
  align-items: start;
  max-width: 1180px;
  margin: 0 auto;
  padding: var(--space-8) var(--space-6) var(--space-24);
}

/* ---------- Sidebar ---------- */

.api-docs-nav-toggle {
  position: sticky;
  top: calc(var(--space-24) + var(--space-4));
  z-index: 1;
  align-self: start;
}

.api-docs-nav {
  display: flex;
  flex-direction: column;
  max-height: calc(100vh - (var(--space-24) + var(--space-4)));
  overflow: hidden;
  padding: var(--space-4) var(--space-3);
  border: 1px solid var(--glass-border);
  border-radius: var(--radius-lg);
  background: var(--color-surface);
}

.api-docs-nav__api-info {
  flex: none;
  padding: var(--space-1) var(--space-2) var(--space-4);
  border-bottom: 1px solid var(--glass-border);
  margin-bottom: var(--space-2);
}

.api-docs-nav__api-version {
  font-size: var(--fs-sm);
  font-weight: 700;
  color: var(--color-text-muted);
  letter-spacing: 0.03em;
}

.api-docs-nav__scroll {
  min-height: 0;
  max-height: calc(100vh - (var(--space-24) + var(--space-4)) - 7rem);
  overflow-y: auto;
  overscroll-behavior: contain;
  scrollbar-color: var(--glass-border) transparent;
  scrollbar-width: thin;
}

.api-docs-nav__scroll::-webkit-scrollbar {
  width: 6px;
}

.api-docs-nav__scroll::-webkit-scrollbar-track {
  background: transparent;
}

.api-docs-nav__scroll::-webkit-scrollbar-thumb {
  background: var(--glass-border);
  border-radius: var(--radius-full);
}

.api-docs-nav__category {
  margin-bottom: 4px;
}

.api-docs-nav__category-title {
  font-size: 0.6875rem;
  font-weight: 700;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  color: var(--color-text-muted);
  padding: var(--space-2);
  margin: 0;
}

.api-docs-nav__op-list {
  list-style: none;
  margin: 0;
  padding: 0 0 0 4px;
  display: grid;
  gap: 1px;
}

.api-docs-nav__op-link {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-2);
  border-radius: var(--radius-md);
  font-size: 0.8125rem;
  color: var(--color-text-muted);
  text-decoration: none;
  transition: background-color 150ms ease, color 150ms ease;
  box-shadow: inset 2px 0 0 transparent;
}

.api-docs-nav__op-path {
  overflow-wrap: anywhere;
}

.api-docs-nav__op-link:hover {
  background: rgba(255, 255, 255, 0.06);
  color: var(--color-text);
}

.api-docs-nav__op-link:focus-visible {
  outline: 2px solid var(--color-accent);
  outline-offset: 2px;
}

.api-docs-nav__op-link[aria-current="true"] {
  background: rgba(37, 99, 235, 0.15);
  color: var(--color-text);
  box-shadow: inset 2px 0 0 var(--color-primary);
}

/* ---------- Method verb badges ---------- */
/* PATCH has no dedicated warning token in tokens-palette-dark.css, so a
   standalone amber (#F59E0B) is used here as the third verb color. */

.api-docs-verb {
  font-size: 10px;
  font-weight: 800;
  letter-spacing: 0.03em;
  padding: 2px 6px;
  border-radius: 4px;
  min-width: 42px;
  text-align: center;
  display: inline-block;
}

.api-docs-verb--get {
  color: var(--color-accent);
  background: rgba(96, 165, 250, 0.14);
}

.api-docs-verb--post {
  color: #93c5fd;
  background: rgba(37, 99, 235, 0.2);
}

.api-docs-verb--patch {
  color: #f59e0b;
  background: rgba(245, 158, 11, 0.14);
}

/* ---------- Content column ---------- */

.api-docs-content {
  min-width: 0;
}

.api-docs-category-heading {
  font-size: var(--fs-xl);
  color: var(--color-text);
  margin: 48px 0 8px;
  scroll-margin-top: 96px;
}

.api-docs-category-heading:first-child {
  margin-top: 0;
}

.api-docs-category-desc {
  color: var(--color-text-muted);
  font-size: var(--fs-sm);
  line-height: 1.6;
  margin: 0 0 var(--space-6);
}

.api-endpoint {
  scroll-margin-top: 96px;
  padding-bottom: 32px;
  margin-bottom: 32px;
  border-bottom: 1px solid var(--glass-border);
}

.api-endpoint:last-child {
  border-bottom: none;
}

.api-endpoint__head {
  display: flex;
  align-items: center;
  gap: 10px;
  flex-wrap: wrap;
  margin-bottom: 8px;
}

.api-endpoint__path {
  font-family: ui-monospace, "SFMono-Regular", Menlo, Consolas, monospace;
  font-size: var(--fs-sm);
  font-weight: 600;
  color: var(--color-text);
}

.api-endpoint__title {
  font-size: var(--fs-lg);
  color: var(--color-text);
  margin: 0 0 6px;
}

.api-endpoint__desc {
  color: var(--color-text-muted);
  font-size: var(--fs-sm);
  line-height: 1.6;
  margin: 0 0 16px;
  max-width: 62ch;
}

/* ---------- Warning callout ---------- */
/* Distinguished by color + a leading icon glyph (not color alone), so the
   warning also reads for viewers who can't perceive the amber hue. */

.api-docs-callout {
  display: flex;
  gap: 10px;
  align-items: flex-start;
  font-size: var(--fs-sm);
  line-height: 1.55;
  background: rgba(245, 158, 11, 0.1);
  border: 1px solid rgba(245, 158, 11, 0.35);
  color: #fbbf24;
  border-radius: 10px;
  padding: 12px 14px;
  margin-bottom: 18px;
}

.api-docs-callout__icon {
  flex: none;
  font-size: 14px;
  line-height: 1.4;
}

/* ---------- Params table ---------- */

.api-docs-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.8125rem;
  margin-bottom: var(--space-4);
}

.api-docs-table caption {
  text-align: left;
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--color-text-muted);
  margin-bottom: 8px;
  font-weight: 700;
}

.api-docs-table th {
  text-align: left;
  color: var(--color-text-muted);
  font-weight: 600;
  padding: 6px 10px;
  border-bottom: 1px solid var(--glass-border);
  font-size: 11px;
}

.api-docs-table td {
  padding: 8px 10px;
  border-bottom: 1px solid var(--glass-border);
  color: var(--color-text);
}

.api-docs-table code {
  font-size: 11.5px;
  color: var(--color-accent);
}

/* ---------- Code blocks ---------- */

.api-docs-block {
  border: 1px solid var(--glass-border);
  border-radius: 12px;
  overflow: hidden;
  margin-bottom: 14px;
  background: rgba(255, 255, 255, 0.02);
}

.api-docs-block__head {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 9px 12px;
  background: var(--color-surface-solid);
  border-bottom: 1px solid var(--glass-border);
}

.api-docs-block__label {
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  color: var(--color-text-muted);
}

.api-docs-copy-btn {
  display: flex;
  align-items: center;
  gap: 6px;
  font: inherit;
  font-size: 11px;
  font-weight: 600;
  color: var(--color-text-muted);
  background: transparent;
  padding: 4px 9px;
  min-height: 28px;
  border-radius: 7px;
  border: 1px solid var(--glass-border);
  cursor: pointer;
  transition: color 150ms ease, border-color 150ms ease, background-color 150ms ease;
}

.api-docs-copy-btn:hover {
  color: var(--color-text);
  border-color: var(--color-accent);
  background: rgba(96, 165, 250, 0.08);
}

.api-docs-copy-btn:focus-visible {
  outline: 2px solid var(--color-accent);
  outline-offset: 2px;
}

.api-docs-copy-btn.is-copied {
  color: #34d399;
  border-color: #34d399;
}

.api-docs-block pre {
  margin: 0;
  padding: var(--space-4);
  font-size: 0.8125rem;
  line-height: 1.6;
  overflow-x: auto;
  color: var(--color-text);
  font-family: ui-monospace, "SFMono-Regular", Menlo, Consolas, monospace;
}

/* ---------- Sidebar wrapper: <details class="api-docs-nav-toggle"><summary/><nav class="api-docs-nav">.
   Desktop: the toggle affordance (summary) is hidden and the nav is forced visible via an
   author-CSS override of the browser's default "hide closed <details> content" behavior, so no
   `open` attribute is required at that breakpoint. Mobile: the override is removed so native
   <details>/<summary> disclosure behavior (no JS) controls collapse/expand. ---------- */

.api-docs-nav-toggle > summary {
  display: none;
}

.api-docs-nav-toggle .api-docs-nav {
  display: block;
}

@media (max-width: 767px) {
  .api-docs-layout {
    grid-template-columns: 1fr;
    padding: 20px 16px 64px;
    gap: 16px;
  }

  .api-docs-nav-toggle {
    position: static;
  }

  .api-docs-nav-toggle > summary {
    list-style: none;
    cursor: pointer;
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 8px;
    padding: 12px 14px;
    border: 1px solid var(--glass-border);
    border-radius: 10px;
    background: var(--color-surface);
    color: var(--color-text);
    font-size: 13px;
    font-weight: 600;
  }

  .api-docs-nav-toggle > summary::-webkit-details-marker {
    display: none;
  }

  .api-docs-nav-toggle > summary:focus-visible {
    outline: 2px solid var(--color-accent);
    outline-offset: 2px;
  }

  .api-docs-nav-toggle[open] > summary {
    border-radius: 10px 10px 0 0;
  }

  .api-docs-nav-toggle .api-docs-nav {
    display: none;
    max-height: none;
    overflow: visible;
    border: 1px solid var(--glass-border);
    border-top: none;
    border-radius: 0 0 10px 10px;
    background: var(--color-surface);
    padding: 12px;
  }

  .api-docs-nav-toggle[open] .api-docs-nav {
    display: block;
  }

  .api-docs-nav__scroll {
    max-height: none;
    overflow-y: visible;
  }
}

/* ---------- Reduced motion ---------- */

@media (prefers-reduced-motion: reduce) {
  html {
    scroll-behavior: auto;
  }

  .api-docs-nav__op-link,
  .api-docs-copy-btn {
    transition: none;
  }
}