/* ==================================================================
   API Documentation Components
   ================================================================== */

/* --- Nav Menu Actions (right-aligned buttons) --- */

.nav-menu-actions {
  display: flex;
  gap: var(--spacing-sm);
  align-items: center;
}

.nav-menu .nav-menu-actions a {
  color: white;
  font-size: var(--font-size-sm);
  font-weight: var(--font-weight-medium);
}

.nav-menu .nav-menu-actions a:hover {
  color: white;
}

/* --- Catalog Page --- */

.api-catalog-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(340px, 1fr));
  gap: var(--spacing-xl);
  margin-top: var(--spacing-xl);
}

.api-catalog-card {
  background: var(--color-bg-white);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  padding: var(--spacing-2xl);
  text-decoration: none;
  color: inherit;
  transition: box-shadow var(--transition-base), border-color var(--transition-base);
  display: flex;
  flex-direction: column;
}

.api-catalog-card:hover,
.api-catalog-card:active,
.api-catalog-card:focus {
  text-decoration: none;
  box-shadow: var(--shadow-md);
  border-color: var(--color-primary);
}

.api-catalog-card h3 {
  font-size: var(--font-size-xl);
  color: var(--color-primary);
  margin: 0 0 var(--spacing-sm) 0;
}

.api-catalog-card p {
  font-size: var(--font-size-base);
  color: var(--color-text-secondary);
  margin: 0 0 var(--spacing-lg) 0;
  flex: 1;
}

.api-catalog-card .endpoint-badge {
  display: inline-flex;
  align-items: center;
  gap: var(--spacing-sm);
  font-size: var(--font-size-sm);
  font-family: monospace;
  color: var(--color-text-muted);
}

.api-catalog-card .method-badge {
  display: inline-block;
  background: var(--color-success);
  color: white;
  padding: 2px var(--spacing-sm);
  border-radius: var(--radius-sm);
  font-size: var(--font-size-xs);
  font-weight: var(--font-weight-bold);
  text-transform: uppercase;
  letter-spacing: 0.5px;
}

/* --- Endpoint Page --- */

.endpoint-header {
  margin-bottom: var(--spacing-3xl);
}

.endpoint-header h1 {
  margin-bottom: var(--spacing-sm);
}

.endpoint-header .endpoint-url {
  display: inline-flex;
  align-items: center;
  gap: var(--spacing-sm);
  font-family: monospace;
  font-size: var(--font-size-md);
  background: var(--color-gray-100);
  padding: var(--spacing-sm) var(--spacing-lg);
  border-radius: var(--radius-md);
  border: 1px solid var(--color-border);
}

/* --- Section-Aligned Two-Column Reference --- */

/* Full-width section (Header Parameters, etc.) */
.api-section-full {
  margin-top: var(--spacing-3xl);
}

.api-section-full h3 {
  font-size: var(--font-size-xl);
  color: var(--color-gray-800);
  margin: 0 0 var(--spacing-lg) 0;
  padding-bottom: var(--spacing-sm);
  border-bottom: 2px solid var(--color-primary);
}

/* Each row aligns schema (left) with code sample (right) */
.api-reference-row {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--spacing-4xl);
  align-items: start;
  margin-top: var(--spacing-3xl);
}

.api-reference-row .api-reference-left h3 {
  font-size: var(--font-size-xl);
  color: var(--color-gray-800);
  margin: 0 0 var(--spacing-lg) 0;
  padding-bottom: var(--spacing-sm);
  border-bottom: 2px solid var(--color-primary);
}

.api-reference-row .api-reference-right h3 {
  font-size: var(--font-size-lg);
  color: var(--color-gray-800);
  margin: 0 0 var(--spacing-md) 0;
}

.api-reference-row .api-reference-right {
  min-width: 0;
}

.api-reference-row .api-reference-right .code-block pre {
  overflow-x: auto;
}

/* Error status table at full width below the reference rows */
.api-section-errors {
  margin-top: var(--spacing-3xl);
}

.api-section-errors h3 {
  font-size: var(--font-size-xl);
  color: var(--color-gray-800);
  margin: 0 0 var(--spacing-lg) 0;
  padding-bottom: var(--spacing-sm);
  border-bottom: 2px solid var(--color-primary);
}

/* --- Parameter Tables --- */

.param-table {
  width: 100%;
  border-collapse: collapse;
  margin-top: var(--spacing-md);
  margin-bottom: var(--spacing-lg);
}

.param-table th {
  background: var(--color-gray-50);
  padding: var(--spacing-sm) var(--spacing-md);
  text-align: left;
  font-size: var(--font-size-sm);
  font-weight: var(--font-weight-semibold);
  border-bottom: 2px solid var(--color-border);
  color: var(--color-text-secondary);
}

.param-table td {
  padding: var(--spacing-sm) var(--spacing-md);
  font-size: var(--font-size-sm);
  border-bottom: 1px solid var(--color-border-light);
  vertical-align: top;
}

.param-table td code {
  font-size: var(--font-size-sm);
  background: var(--color-gray-100);
  padding: 1px 5px;
  border-radius: var(--radius-sm);
}

.param-required {
  color: var(--color-danger);
  font-weight: var(--font-weight-semibold);
  font-size: var(--font-size-xs);
}

.param-optional {
  color: var(--color-text-muted);
  font-size: var(--font-size-xs);
}

/* --- Collapsible Schema Fields --- */

.schema-fields {
  margin-top: var(--spacing-md);
}

.schema-fields details {
  border-bottom: 1px solid var(--color-border-light);
}

.schema-fields details:last-child {
  border-bottom: none;
}

.schema-fields summary {
  cursor: pointer;
  padding: var(--spacing-sm) 0;
  font-size: var(--font-size-sm);
  list-style: none;
  display: flex;
  align-items: baseline;
  gap: var(--spacing-sm);
}

.schema-fields summary::-webkit-details-marker {
  display: none;
}

.schema-fields summary::before {
  content: "\25B8";
  font-size: var(--font-size-xs);
  color: var(--color-text-muted);
  transition: transform var(--transition-fast);
  display: inline-block;
  width: 12px;
  flex-shrink: 0;
}

.schema-fields details[open] > summary::before {
  transform: rotate(90deg);
}

.schema-fields summary code {
  font-size: var(--font-size-sm);
  background: var(--color-gray-100);
  padding: 1px 5px;
  border-radius: var(--radius-sm);
}

.schema-type {
  font-size: var(--font-size-xs);
  color: var(--color-text-muted);
}

.schema-required {
  color: var(--color-danger);
  font-weight: var(--font-weight-semibold);
  font-size: var(--font-size-xs);
}

.schema-desc {
  font-size: var(--font-size-sm);
  color: var(--color-text-secondary);
  padding: 0 0 var(--spacing-sm) 20px;
  margin: 0;
}

.schema-children {
  padding-left: 20px;
}

/* Leaf fields (no children, no expand arrow) */
.schema-leaf {
  padding: var(--spacing-sm) 0;
  font-size: var(--font-size-sm);
  border-bottom: 1px solid var(--color-border-light);
  display: flex;
  align-items: baseline;
  gap: var(--spacing-sm);
  padding-left: 12px;
}

.schema-leaf:last-child {
  border-bottom: none;
}

.schema-leaf code {
  font-size: var(--font-size-sm);
  background: var(--color-gray-100);
  padding: 1px 5px;
  border-radius: var(--radius-sm);
}

/* --- Dark Code Blocks (Rouge) --- */

.code-block {
  position: relative;
  margin-bottom: var(--spacing-xl);
  border-radius: var(--radius-lg);
  overflow: hidden;
}

.code-block pre {
  background: #1e1e2e;
  color: #cdd6f4;
  padding: var(--spacing-xl);
  padding-top: var(--spacing-3xl);
  border-radius: var(--radius-lg);
  overflow-x: auto;
  margin: 0;
  font-size: var(--font-size-sm);
  line-height: 1.6;
}

.code-block pre code {
  font-family: "SF Mono", "Fira Code", "Fira Mono", Menlo, Consolas, monospace;
  background: none;
  padding: 0;
  color: inherit;
}

.code-copy-btn {
  position: absolute;
  top: var(--spacing-sm);
  right: var(--spacing-md);
  background: rgba(255, 255, 255, 0.1);
  color: #a6adc8;
  border: 1px solid rgba(255, 255, 255, 0.15);
  padding: 3px var(--spacing-md);
  border-radius: var(--radius-sm);
  font-size: var(--font-size-xs);
  cursor: pointer;
  transition: background var(--transition-fast), color var(--transition-fast);
  z-index: 1;
}

.code-copy-btn:hover {
  background: rgba(255, 255, 255, 0.2);
  color: #cdd6f4;
}

/* --- Rouge Syntax Highlighting (Catppuccin Mocha) --- */

.highlight .c,
.highlight .c1,
.highlight .cm { color: #6c7086; font-style: italic; }  /* comments */
.highlight .s,
.highlight .s1,
.highlight .s2 { color: #a6e3a1; }                       /* strings */
.highlight .mi,
.highlight .mf,
.highlight .mh { color: #fab387; }                       /* numbers */
.highlight .kc { color: #fab387; }                       /* true/false/null */
.highlight .k,
.highlight .kd,
.highlight .kn { color: #cba6f7; }                       /* keywords */
.highlight .na,
.highlight .nl { color: #89b4fa; }                       /* attributes / JSON keys */
.highlight .p  { color: #cdd6f4; }                       /* punctuation */
.highlight .nb { color: #f9e2af; }                       /* builtins */
.highlight .nt { color: #89b4fa; }                       /* tags / names */
.highlight .err { color: #f38ba8; }                       /* errors */

/* --- Intro Prose Section --- */

.api-prose {
  max-width: 780px;
  margin-bottom: var(--spacing-3xl);
  line-height: 1.7;
  color: var(--color-text-secondary);
}

.api-prose p {
  margin-bottom: var(--spacing-lg);
}

.api-prose code {
  background: var(--color-gray-100);
  padding: 1px 5px;
  border-radius: var(--radius-sm);
  font-size: var(--font-size-sm);
}

/* --- Section Divider --- */

.api-divider {
  border: none;
  border-top: 1px solid var(--color-border);
  margin: var(--spacing-4xl) 0;
}

/* --- Status Code Table --- */

.status-table {
  width: 100%;
  border-collapse: collapse;
  margin-top: var(--spacing-md);
}

.status-table td {
  padding: var(--spacing-sm) var(--spacing-md);
  font-size: var(--font-size-sm);
  border-bottom: 1px solid var(--color-border-light);
  vertical-align: top;
}

.status-table td:first-child {
  font-family: monospace;
  font-weight: var(--font-weight-semibold);
  width: 60px;
}

/* --- Quick Start Card --- */

.quick-start-card {
  background: var(--color-bg-white);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  padding: var(--spacing-2xl) var(--spacing-3xl);
}

.quick-start-card h2 {
  font-size: var(--font-size-2xl);
  color: var(--color-gray-800);
  margin: 0 0 var(--spacing-lg) 0;
}

.quick-start-card p {
  font-size: var(--font-size-base);
  line-height: 1.7;
  color: var(--color-text-secondary);
  margin-bottom: var(--spacing-lg);
}

.quick-start-card code {
  background: var(--color-gray-100);
  padding: 1px 5px;
  border-radius: var(--radius-sm);
  font-size: var(--font-size-sm);
}

.quick-start-endpoint {
  display: inline-flex;
  align-items: center;
  gap: var(--spacing-sm);
  font-family: monospace;
  font-size: var(--font-size-md);
  background: var(--color-gray-100);
  padding: var(--spacing-sm) var(--spacing-lg);
  border-radius: var(--radius-md);
  border: 1px solid var(--color-border);
  margin-bottom: var(--spacing-lg);
}

.quick-start-header {
  font-family: monospace;
  font-size: var(--font-size-sm);
  color: var(--color-text-secondary);
  margin-bottom: var(--spacing-lg);
}

.quick-start-header strong {
  color: var(--color-text-primary);
}

/* --- Try It Out --- */

.api-try-it {
  margin-top: var(--spacing-4xl);
  border-top: 1px solid var(--color-border);
  padding-top: var(--spacing-4xl);
}

.api-try-it h2 {
  font-size: var(--font-size-2xl);
  color: var(--color-gray-800);
  margin: 0 0 var(--spacing-lg) 0;
}

.api-try-it p {
  color: var(--color-text-secondary);
  margin-bottom: var(--spacing-xl);
}

.api-try-form {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--spacing-4xl);
  align-items: start;
}

.api-try-fields {
  display: flex;
  flex-direction: column;
  gap: var(--spacing-md);
}

.api-try-section-header {
  font-size: var(--font-size-base);
  color: var(--color-gray-800);
  margin: var(--spacing-md) 0 var(--spacing-sm) 0;
  padding-bottom: var(--spacing-xs);
  border-bottom: 1px solid var(--color-border);
}

.api-try-fields label {
  font-size: var(--font-size-sm);
  font-weight: var(--font-weight-semibold);
  color: var(--color-text-secondary);
  margin-bottom: 2px;
}

.api-try-fields input {
  padding: var(--spacing-sm) var(--spacing-md);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-sm);
  font-size: var(--font-size-sm);
  font-family: monospace;
}

.api-try-fields input:focus {
  outline: none;
  border-color: var(--color-primary);
  box-shadow: 0 0 0 2px rgba(30, 60, 114, 0.15);
}

.api-try-fields .field-group {
  display: flex;
  flex-direction: column;
}

.api-try-fields .field-row {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--spacing-md);
}

.api-try-output {
  background: #1e1e2e;
  color: #cdd6f4;
  padding: var(--spacing-xl);
  border-radius: var(--radius-lg);
  font-family: "SF Mono", "Fira Code", "Fira Mono", Menlo, Consolas, monospace;
  font-size: var(--font-size-sm);
  line-height: 1.6;
  white-space: pre-wrap;
  word-break: break-word;
  min-height: 200px;
  overflow-x: auto;
}

.api-try-output-wrapper {
  position: relative;
}

.api-try-output:empty::before {
  content: "Response will appear here...";
  color: #6c7086;
  font-style: italic;
}

/* --- Responsive --- */

@media (max-width: 900px) {
  .api-reference-row {
    grid-template-columns: 1fr;
    gap: var(--spacing-xl);
  }

  .api-catalog-grid {
    grid-template-columns: 1fr;
  }

  .nav-menu-actions {
    display: none;
  }
}