/* NIIO Documentation Styles - Professional Documentation Design */

/* RedHatDisplay Variable Font (alineado con styles.css / app-niio) */
@font-face {
  font-family: 'RedHatDisplay';
  src: url('/fonts/RedHatDisplay-VariableFont_wght.ttf') format('truetype');
  font-weight: 300 900;
  font-display: swap;
}

:root {
  /* Colors — light theme (alineado con DESIGN.md NiioPay 2025) */
  --docs-bg: #ffffff;
  --docs-bg-subtle: #F6F9FC;
  --docs-bg-muted: #f1f5f9;
  --docs-border: #E4E7EF;
  --docs-border-subtle: #f1f5f9;

  --docs-text: #171D33;            /* navy tinta, nunca negro puro */
  --docs-text-secondary: #4A5884;  /* índigo oficial */
  --docs-text-muted: #57648E;

  /* Petróleo = único color accionable (links/botones/activo). 9.0:1 sobre blanco.
     El cyan #2FB1ED queda como acento decorativo (mesh, focus glow), nunca como texto. */
  --docs-primary: #004E72;
  --docs-primary-hover: #005E88;
  --docs-primary-press: #003B57;
  --docs-primary-subtle: #EAF7FE;  /* canvas-tint */
  --docs-accent: #2FB1ED;          /* cyan: solo glow/acento */

  --docs-success: #15803D;
  --docs-success-subtle: #E8F7EF;
  --docs-warning: #8A5A00;
  --docs-warning-subtle: #FEF3C7;
  --docs-error: #B3223B;
  --docs-error-subtle: #FDECEF;
  --docs-info: #004E72;
  --docs-info-subtle: #EAF7FE;

  /* Code colors */
  --code-bg: #171D33;              /* navy tinta */
  --code-header-bg: rgba(255, 255, 255, 0.04);
  --code-text: #E4E7EF;
  --code-comment: #7A88B0;
  --code-keyword: #c084fc;
  --code-string: #40E0D0;          /* turquesa de marca */
  --code-number: #fbbf24;
  --code-function: #60a5fa;

  /* Sombras */
  --docs-shadow-sm: 0 1px 3px rgba(23, 29, 51, 0.08);
  --docs-shadow-md: 0 8px 24px rgba(23, 29, 51, 0.08), 0 2px 6px rgba(23, 29, 51, 0.04);

  /* Spacing */
  --docs-sidebar-width: 260px;
  --docs-toc-width: 220px;
  --docs-header-height: 60px;
  --docs-content-max-width: 760px;

  /* Typography */
  --font-sans: 'RedHatDisplay', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
  --font-mono: 'JetBrains Mono', 'Fira Code', Consolas, monospace;

  color-scheme: light;
}

/* Dark theme — activado por atributo (toggle) o por preferencia del SO */
:root[data-theme='dark'] {
  --docs-bg: #0E1120;
  --docs-bg-subtle: #171D33;
  --docs-bg-muted: #1F2740;
  --docs-border: #2A3350;
  --docs-border-subtle: #222A44;

  --docs-text: #EAEDF7;
  --docs-text-secondary: #A9B4D6;
  --docs-text-muted: #7A88B0;

  /* En oscuro el cyan SÍ contrasta: es el accionable. Petróleo pierde legibilidad. */
  --docs-primary: #4FC3F7;
  --docs-primary-hover: #7FD4F9;
  --docs-primary-press: #2FB1ED;
  --docs-primary-subtle: rgba(47, 177, 237, 0.14);
  --docs-accent: #40E0D0;

  --docs-success: #4ADE80;
  --docs-success-subtle: rgba(74, 222, 128, 0.12);
  --docs-warning: #FBBF24;
  --docs-warning-subtle: rgba(251, 191, 36, 0.12);
  --docs-error: #FB7185;
  --docs-error-subtle: rgba(251, 113, 133, 0.12);
  --docs-info: #4FC3F7;
  --docs-info-subtle: rgba(79, 195, 247, 0.12);

  --code-bg: #0A0E1C;
  --code-header-bg: rgba(255, 255, 255, 0.03);
  --code-text: #EAEDF7;
  --code-comment: #6B77A0;

  --docs-shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.4);
  --docs-shadow-md: 0 8px 24px rgba(0, 0, 0, 0.5), 0 2px 6px rgba(0, 0, 0, 0.3);

  color-scheme: dark;
}

@media (prefers-color-scheme: dark) {
  :root:not([data-theme='light']) {
    --docs-bg: #0E1120;
    --docs-bg-subtle: #171D33;
    --docs-bg-muted: #1F2740;
    --docs-border: #2A3350;
    --docs-border-subtle: #222A44;

    --docs-text: #EAEDF7;
    --docs-text-secondary: #A9B4D6;
    --docs-text-muted: #7A88B0;

    --docs-primary: #4FC3F7;
    --docs-primary-hover: #7FD4F9;
    --docs-primary-press: #2FB1ED;
    --docs-primary-subtle: rgba(47, 177, 237, 0.14);
    --docs-accent: #40E0D0;

    --docs-success: #4ADE80;
    --docs-success-subtle: rgba(74, 222, 128, 0.12);
    --docs-warning: #FBBF24;
    --docs-warning-subtle: rgba(251, 191, 36, 0.12);
    --docs-error: #FB7185;
    --docs-error-subtle: rgba(251, 113, 133, 0.12);
    --docs-info: #4FC3F7;
    --docs-info-subtle: rgba(79, 195, 247, 0.12);

    --code-bg: #0A0E1C;
    --code-header-bg: rgba(255, 255, 255, 0.03);
    --code-text: #EAEDF7;
    --code-comment: #6B77A0;

    --docs-shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.4);
    --docs-shadow-md: 0 8px 24px rgba(0, 0, 0, 0.5), 0 2px 6px rgba(0, 0, 0, 0.3);

    color-scheme: dark;
  }
}

/* Reset */
*, *::before, *::after {
  box-sizing: border-box;
  margin: 0;
  padding: 0;
}

html {
  scroll-behavior: smooth;
  scroll-padding-top: calc(var(--docs-header-height) + 24px);
}

body {
  font-family: var(--font-sans);
  font-size: 15px;
  line-height: 1.7;
  color: var(--docs-text);
  background: var(--docs-bg);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}

/* Header */
.docs-header {
  position: fixed;
  top: 0;
  left: 0;
  right: 0;
  height: var(--docs-header-height);
  background: color-mix(in srgb, var(--docs-bg) 88%, transparent);
  backdrop-filter: blur(8px);
  -webkit-backdrop-filter: blur(8px);
  border-bottom: 1px solid var(--docs-border);
  z-index: 100;
}

.docs-header-inner {
  max-width: 1600px;
  margin: 0 auto;
  height: 100%;
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0 24px;
}

.docs-logo {
  display: flex;
  align-items: center;
  gap: 12px;
  text-decoration: none;
  color: var(--docs-text);
}

.docs-logo img {
  height: 28px;
}

.docs-logo-text {
  font-size: 14px;
  font-weight: 500;
  color: var(--docs-text-secondary);
  padding-left: 12px;
  border-left: 1px solid var(--docs-border);
}

.docs-top-nav {
  display: flex;
  align-items: center;
  gap: 32px;
}

.docs-top-nav-link {
  font-size: 14px;
  font-weight: 500;
  color: var(--docs-text-secondary);
  text-decoration: none;
  transition: color 0.15s;
}

.docs-top-nav-link:hover {
  color: var(--docs-text);
}

.docs-header-actions {
  display: flex;
  align-items: center;
  gap: 12px;
}

/* Icon buttons (theme toggle, mobile menu) */
.docs-icon-btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 38px;
  height: 38px;
  padding: 0;
  background: transparent;
  border: 1px solid var(--docs-border);
  border-radius: 8px;
  color: var(--docs-text-secondary);
  cursor: pointer;
  transition: all 0.15s;
  flex-shrink: 0;
}

.docs-icon-btn:hover {
  color: var(--docs-text);
  border-color: var(--docs-primary);
  background: var(--docs-bg-subtle);
}

/* Theme toggle: show sun in dark, moon in light */
.docs-theme-toggle .icon-moon { display: block; }
.docs-theme-toggle .icon-sun { display: none; }
:root[data-theme='dark'] .docs-theme-toggle .icon-moon { display: none; }
:root[data-theme='dark'] .docs-theme-toggle .icon-sun { display: block; }
@media (prefers-color-scheme: dark) {
  :root:not([data-theme='light']) .docs-theme-toggle .icon-moon { display: none; }
  :root:not([data-theme='light']) .docs-theme-toggle .icon-sun { display: block; }
}

/* Mobile menu button — hidden on desktop */
.docs-menu-btn { display: none; }

/* Invert the NIIO logo (dark navy artwork) on dark backgrounds */
:root[data-theme='dark'] .docs-logo img { filter: brightness(0) invert(1); }
@media (prefers-color-scheme: dark) {
  :root:not([data-theme='light']) .docs-logo img { filter: brightness(0) invert(1); }
}

/* Backdrop for the mobile sidebar drawer */
.docs-sidebar-backdrop {
  display: none;
  position: fixed;
  inset: 0;
  background: rgba(14, 17, 32, 0.5);
  backdrop-filter: blur(2px);
  z-index: 90;
}
.docs-sidebar-backdrop.open { display: block; }

.docs-search-btn {
  display: flex;
  align-items: center;
  gap: 8px;
  padding: 8px 12px;
  background: var(--docs-bg-subtle);
  border: 1px solid var(--docs-border);
  border-radius: 8px;
  font-size: 13px;
  color: var(--docs-text-muted);
  cursor: pointer;
  transition: all 0.15s;
  min-width: 200px;
}

.docs-search-btn:hover {
  border-color: var(--docs-primary);
  color: var(--docs-text-secondary);
}

.docs-search-btn kbd {
  margin-left: auto;
  padding: 2px 6px;
  background: var(--docs-bg);
  border: 1px solid var(--docs-border);
  border-radius: 4px;
  font-family: var(--font-sans);
  font-size: 11px;
}

/* Container */
.docs-container {
  display: flex;
  max-width: 1600px;
  margin: 0 auto;
  padding-top: var(--docs-header-height);
}

/* Sidebar */
.docs-sidebar {
  position: fixed;
  top: var(--docs-header-height);
  left: 0;
  bottom: 0;
  width: var(--docs-sidebar-width);
  padding: 24px 16px;
  border-right: 1px solid var(--docs-border);
  overflow-y: auto;
  display: flex;
  flex-direction: column;
}

.docs-nav {
  flex: 1;
}

.docs-nav-section {
  margin-bottom: 24px;
}

.docs-nav-title {
  font-size: 11px;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--docs-text-muted);
  padding: 0 12px;
  margin-bottom: 8px;
}

.docs-nav-link {
  display: flex;
  align-items: center;
  gap: 10px;
  padding: 8px 12px;
  font-size: 14px;
  font-weight: 450;
  color: var(--docs-text-secondary);
  text-decoration: none;
  border-radius: 6px;
  transition: all 0.15s;
}

.docs-nav-link:hover {
  color: var(--docs-text);
  background: var(--docs-bg-subtle);
}

.docs-nav-link.active {
  color: var(--docs-primary);
  background: var(--docs-primary-subtle);
}

.docs-nav-link svg {
  opacity: 0.6;
  flex-shrink: 0;
}

.docs-nav-link.active svg {
  opacity: 1;
}

.docs-sidebar-footer {
  padding-top: 16px;
  border-top: 1px solid var(--docs-border);
  display: flex;
  flex-direction: column;
  gap: 4px;
}

.docs-sidebar-link {
  display: flex;
  align-items: center;
  gap: 8px;
  padding: 8px 12px;
  font-size: 13px;
  color: var(--docs-text-muted);
  text-decoration: none;
  border-radius: 6px;
  transition: all 0.15s;
}

.docs-sidebar-link:hover {
  color: var(--docs-text-secondary);
  background: var(--docs-bg-subtle);
}

/* Main Content */
.docs-main {
  flex: 1;
  margin-left: var(--docs-sidebar-width);
  display: flex;
  min-height: calc(100vh - var(--docs-header-height));
}

.docs-content {
  flex: 1;
  max-width: var(--docs-content-max-width);
  padding: 48px 64px;
  margin: 0 auto;
}

/* Table of Contents */
.docs-toc {
  position: sticky;
  top: calc(var(--docs-header-height) + 48px);
  width: var(--docs-toc-width);
  max-height: calc(100vh - var(--docs-header-height) - 96px);
  padding: 0 24px;
  overflow-y: auto;
  flex-shrink: 0;
}

.docs-toc-title {
  font-size: 11px;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--docs-text-muted);
  margin-bottom: 12px;
}

.docs-toc-nav a {
  display: block;
  padding: 6px 0;
  font-size: 13px;
  color: var(--docs-text-muted);
  text-decoration: none;
  border-left: 2px solid transparent;
  padding-left: 12px;
  margin-left: -2px;
  transition: all 0.15s;
}

.docs-toc-nav a:hover {
  color: var(--docs-text-secondary);
}

.docs-toc-nav a.active {
  color: var(--docs-primary);
  border-left-color: var(--docs-primary);
}

.docs-toc-nav a.toc-h3 {
  padding-left: 24px;
  font-size: 12px;
}

/* Typography */
.docs-content h1 {
  font-size: 36px;
  font-weight: 700;
  line-height: 1.2;
  margin-bottom: 16px;
  letter-spacing: -0.02em;
}

.docs-content h2 {
  font-size: 24px;
  font-weight: 600;
  line-height: 1.3;
  margin-top: 48px;
  margin-bottom: 16px;
  padding-top: 24px;
  border-top: 1px solid var(--docs-border);
  letter-spacing: -0.01em;
}

.docs-content h2:first-of-type {
  margin-top: 32px;
  border-top: none;
  padding-top: 0;
}

.docs-content h3 {
  font-size: 18px;
  font-weight: 600;
  line-height: 1.4;
  margin-top: 32px;
  margin-bottom: 12px;
}

.docs-content p {
  margin-bottom: 16px;
  color: var(--docs-text-secondary);
}

.docs-content .lead {
  font-size: 18px;
  line-height: 1.6;
  color: var(--docs-text-secondary);
  margin-bottom: 32px;
}

.docs-content a {
  color: var(--docs-primary);
  text-decoration: none;
  font-weight: 500;
  text-underline-offset: 2px;
}

.docs-content a:hover {
  color: var(--docs-primary-hover);
  text-decoration: underline;
}

.docs-content ul, .docs-content ol {
  margin-bottom: 16px;
  padding-left: 24px;
  color: var(--docs-text-secondary);
}

.docs-content li {
  margin-bottom: 8px;
}

.docs-content strong {
  font-weight: 600;
  color: var(--docs-text);
}

/* Code */
.docs-content code {
  font-family: var(--font-mono);
  font-size: 13px;
  padding: 2px 6px;
  background: var(--docs-bg-muted);
  border-radius: 4px;
  color: var(--docs-text);
}

.docs-content pre {
  margin: 24px 0;
  padding: 20px 24px;
  background: var(--code-bg);
  border-radius: 12px;
  overflow-x: auto;
}

.docs-content pre code {
  background: none;
  padding: 0;
  color: var(--code-text);
  font-size: 13px;
  line-height: 1.6;
}

/* Code block with header */
.code-block {
  margin: 24px 0;
  border-radius: 12px;
  overflow: hidden;
  background: var(--code-bg);
}

.code-block-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 12px 16px;
  background: rgba(255, 255, 255, 0.05);
  border-bottom: 1px solid rgba(255, 255, 255, 0.1);
}

.code-block-title {
  font-family: var(--font-mono);
  font-size: 12px;
  color: var(--docs-text-muted);
}

.code-block-copy {
  display: flex;
  align-items: center;
  gap: 6px;
  padding: 4px 8px;
  background: rgba(255, 255, 255, 0.1);
  border: none;
  border-radius: 4px;
  font-size: 11px;
  color: var(--docs-text-muted);
  cursor: pointer;
  transition: all 0.15s;
}

.code-block-copy:hover {
  background: rgba(255, 255, 255, 0.15);
  color: #fff;
}

.code-block-copy.copied {
  color: var(--code-string);
}

/* Floating copy button on bare <pre> blocks */
.docs-content pre.has-copy {
  position: relative;
}

.pre-copy-btn {
  position: absolute;
  top: 12px;
  right: 12px;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  padding: 6px;
  background: rgba(255, 255, 255, 0.08);
  border: none;
  border-radius: 6px;
  color: #94a3b8;
  cursor: pointer;
  opacity: 0;
  transition: opacity 0.15s, background 0.15s, color 0.15s;
}

.docs-content pre.has-copy:hover .pre-copy-btn,
.pre-copy-btn:focus-visible {
  opacity: 1;
}

.pre-copy-btn:hover {
  background: rgba(255, 255, 255, 0.15);
  color: #fff;
}

.pre-copy-btn.copied {
  opacity: 1;
  color: var(--code-string);
}

.code-block pre {
  margin: 0;
  padding: 16px 20px;
  border-radius: 0;
}

/* Code tabs */
.code-tabs {
  margin: 24px 0;
  border-radius: 12px;
  overflow: hidden;
  background: var(--code-bg);
}

.code-tabs-header {
  display: flex;
  background: rgba(255, 255, 255, 0.05);
  border-bottom: 1px solid rgba(255, 255, 255, 0.1);
}

.code-tab-btn {
  padding: 12px 20px;
  background: none;
  border: none;
  font-family: var(--font-mono);
  font-size: 13px;
  color: var(--docs-text-muted);
  cursor: pointer;
  transition: all 0.15s;
  border-bottom: 2px solid transparent;
  margin-bottom: -1px;
}

.code-tab-btn:hover {
  color: #fff;
}

.code-tab-btn.active {
  color: #fff;
  border-bottom-color: var(--docs-primary);
}

.code-tab-content {
  display: none;
}

.code-tab-content.active {
  display: block;
}

.code-tab-content pre {
  margin: 0;
  border-radius: 0;
}

/* Callouts / Alerts */
.callout {
  display: flex;
  gap: 12px;
  padding: 16px;
  border-radius: 8px;
  margin: 24px 0;
}

.callout-icon {
  flex-shrink: 0;
  width: 20px;
  height: 20px;
}

.callout-content {
  flex: 1;
}

.callout-title {
  font-weight: 600;
  font-size: 14px;
  margin-bottom: 4px;
}

.callout-text {
  font-size: 14px;
  line-height: 1.5;
}

.callout-text code {
  font-size: 12px;
}

.callout-info {
  background: var(--docs-info-subtle);
  border: 1px solid rgba(59, 130, 246, 0.2);
}

.callout-info .callout-icon { color: var(--docs-info); }
.callout-info .callout-title { color: var(--docs-info); }

.callout-warning {
  background: var(--docs-warning-subtle);
  border: 1px solid rgba(245, 158, 11, 0.2);
}

.callout-warning .callout-icon { color: var(--docs-warning); }
.callout-warning .callout-title { color: var(--docs-warning); }

.callout-success {
  background: var(--docs-success-subtle);
  border: 1px solid rgba(16, 185, 129, 0.2);
}

.callout-success .callout-icon { color: var(--docs-success); }
.callout-success .callout-title { color: var(--docs-success); }

.callout-error {
  background: var(--docs-error-subtle);
  border: 1px solid rgba(239, 68, 68, 0.2);
}

.callout-error .callout-icon { color: var(--docs-error); }
.callout-error .callout-title { color: var(--docs-error); }

/* Tables */
.docs-content table {
  width: 100%;
  margin: 24px 0;
  border-collapse: collapse;
  font-size: 14px;
}

.docs-content th {
  text-align: left;
  padding: 12px 16px;
  background: var(--docs-bg-subtle);
  border: 1px solid var(--docs-border);
  font-weight: 600;
  color: var(--docs-text);
}

.docs-content td {
  padding: 12px 16px;
  border: 1px solid var(--docs-border);
  color: var(--docs-text-secondary);
}

.docs-content td code {
  font-size: 12px;
}

/* Badges */
.badge {
  display: inline-flex;
  align-items: center;
  padding: 2px 8px;
  font-size: 11px;
  font-weight: 600;
  border-radius: 4px;
  text-transform: uppercase;
  letter-spacing: 0.02em;
}

.badge-get {
  background: var(--docs-success-subtle);
  color: var(--docs-success);
}

.badge-post {
  background: var(--docs-info-subtle);
  color: var(--docs-info);
}

.badge-put, .badge-patch {
  background: var(--docs-warning-subtle);
  color: var(--docs-warning);
}

.badge-delete {
  background: var(--docs-error-subtle);
  color: var(--docs-error);
}

.badge-required {
  background: var(--docs-error-subtle);
  color: var(--docs-error);
}

.badge-optional {
  background: var(--docs-bg-muted);
  color: var(--docs-text-muted);
}

/* Endpoint Card */
.endpoint-card {
  margin: 24px 0;
  border: 1px solid var(--docs-border);
  border-radius: 12px;
  overflow: hidden;
}

.endpoint-header {
  display: flex;
  align-items: center;
  gap: 12px;
  padding: 16px 20px;
  background: var(--docs-bg-subtle);
  border-bottom: 1px solid var(--docs-border);
}

.endpoint-method {
  padding: 4px 10px;
  font-size: 12px;
  font-weight: 700;
  border-radius: 4px;
  font-family: var(--font-mono);
}

.endpoint-method.get { background: var(--docs-success-subtle); color: var(--docs-success); }
.endpoint-method.post { background: var(--docs-info-subtle); color: var(--docs-info); }
.endpoint-method.put, .endpoint-method.patch { background: var(--docs-warning-subtle); color: var(--docs-warning); }
.endpoint-method.delete { background: var(--docs-error-subtle); color: var(--docs-error); }

.endpoint-path {
  font-family: var(--font-mono);
  font-size: 14px;
  color: var(--docs-text);
}

.endpoint-body {
  padding: 20px;
}

.endpoint-description {
  margin-bottom: 20px;
  color: var(--docs-text-secondary);
}

/* Parameter List */
.param-list {
  border: 1px solid var(--docs-border);
  border-radius: 8px;
  overflow: hidden;
}

.param-item {
  padding: 16px;
  border-bottom: 1px solid var(--docs-border);
}

.param-item:last-child {
  border-bottom: none;
}

.param-header {
  display: flex;
  align-items: center;
  gap: 8px;
  margin-bottom: 6px;
}

.param-name {
  font-family: var(--font-mono);
  font-size: 14px;
  font-weight: 500;
  color: var(--docs-text);
}

.param-type {
  font-family: var(--font-mono);
  font-size: 12px;
  color: var(--docs-text-muted);
}

.param-description {
  font-size: 14px;
  color: var(--docs-text-secondary);
  line-height: 1.5;
}

/* Cards Grid */
.cards-grid {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: 16px;
  margin: 24px 0;
}

.doc-card {
  padding: 20px;
  border: 1px solid var(--docs-border);
  border-radius: 12px;
  text-decoration: none;
  transition: all 0.15s;
}

.doc-card {
  background: var(--docs-bg);
}

.doc-card:hover {
  border-color: var(--docs-primary);
  box-shadow: var(--docs-shadow-md);
  transform: translateY(-2px);
}

.doc-card-icon {
  width: 40px;
  height: 40px;
  display: flex;
  align-items: center;
  justify-content: center;
  background: var(--docs-primary-subtle);
  color: var(--docs-primary);
  border-radius: 10px;
  margin-bottom: 12px;
}

.doc-card-title {
  font-size: 16px;
  font-weight: 600;
  color: var(--docs-text);
  margin-bottom: 4px;
}

.doc-card-description {
  font-size: 14px;
  color: var(--docs-text-secondary);
  line-height: 1.5;
}

/* Step List */
.steps {
  counter-reset: step;
  margin: 24px 0;
}

.step {
  position: relative;
  padding-left: 48px;
  padding-bottom: 24px;
  border-left: 2px solid var(--docs-border);
  margin-left: 15px;
}

.step:last-child {
  border-left-color: transparent;
  padding-bottom: 0;
}

.step::before {
  counter-increment: step;
  content: counter(step);
  position: absolute;
  left: -17px;
  top: 0;
  width: 32px;
  height: 32px;
  background: var(--docs-primary);
  color: white;
  border-radius: 50%;
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 14px;
  font-weight: 600;
}

.step-title {
  font-size: 16px;
  font-weight: 600;
  color: var(--docs-text);
  margin-bottom: 8px;
}

.step-content {
  color: var(--docs-text-secondary);
}

/* Response Example */
.response-example {
  margin: 16px 0;
}

.response-header {
  display: flex;
  align-items: center;
  gap: 8px;
  margin-bottom: 8px;
}

.response-status {
  padding: 2px 8px;
  font-size: 12px;
  font-weight: 600;
  border-radius: 4px;
  font-family: var(--font-mono);
}

.response-status.success {
  background: var(--docs-success-subtle);
  color: var(--docs-success);
}

.response-status.error {
  background: var(--docs-error-subtle);
  color: var(--docs-error);
}

.response-label {
  font-size: 13px;
  color: var(--docs-text-muted);
}

/* Syntax Highlighting */
.token.comment { color: var(--code-comment); }
.token.keyword { color: var(--code-keyword); }
.token.string { color: var(--code-string); }
.token.number { color: var(--code-number); }
.token.function { color: var(--code-function); }
.token.property { color: #93c5fd; }
.token.punctuation { color: #94a3b8; }

/* Responsive */
@media (max-width: 1200px) {
  .docs-toc {
    display: none;
  }
}

@media (max-width: 900px) {
  .docs-menu-btn {
    display: inline-flex;
    order: -1;
  }

  /* Sidebar becomes an off-canvas drawer */
  .docs-sidebar {
    transform: translateX(-100%);
    transition: transform 0.25s ease;
    background: var(--docs-bg);
    z-index: 95;
    box-shadow: var(--docs-shadow-md);
    width: 280px;
  }

  .docs-sidebar.open {
    transform: translateX(0);
  }

  .docs-main {
    margin-left: 0;
  }

  .docs-content {
    padding: 32px 24px;
  }

  .cards-grid {
    grid-template-columns: 1fr;
  }

  .docs-top-nav {
    display: none;
  }
}

@media (max-width: 600px) {
  .docs-content h1 {
    font-size: 28px;
  }

  .docs-content h2 {
    font-size: 20px;
  }

  .docs-search-btn {
    min-width: auto;
  }

  .docs-search-btn span,
  .docs-search-btn kbd {
    display: none;
  }
}

/* CTA a la referencia interactiva (Scalar). Petróleo = único accionable. */
.docs-try-cta {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  color: var(--docs-primary);
  background: var(--docs-primary-subtle);
  border: 1px solid var(--docs-border);
  border-radius: 999px;
  padding: 6px 14px;
  font-weight: 600;
}

.docs-try-cta:hover {
  background: var(--docs-primary);
  color: #ffffff;
}

.docs-live-badge {
  margin-left: auto;
  font-size: 10px;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--docs-primary);
  background: var(--docs-primary-subtle);
  border-radius: 6px;
  padding: 2px 6px;
}

/* ─────────────────────────────────────────────────────────────
   Footer del portal
   Antes no existía: /docs no tenía un solo enlace <a> hacia la
   home ni hacia niiopay.com, así que el portal y el sitio de
   marca estaban desconectados para el crawler.
   ───────────────────────────────────────────────────────────── */
.docs-footer {
  margin-left: var(--docs-sidebar-width);
  border-top: 1px solid var(--docs-border);
  background: var(--docs-bg-subtle);
  padding: 48px 64px 24px;
}

.docs-footer-inner {
  display: flex;
  flex-wrap: wrap;
  gap: 48px;
  justify-content: space-between;
  max-width: 1100px;
}

.docs-footer-brand {
  max-width: 300px;
}

.docs-footer-brand p {
  margin: 12px 0 0;
  font-size: 13px;
  line-height: 1.5;
  color: var(--docs-text-muted);
}

.docs-footer-nav {
  display: flex;
  flex-wrap: wrap;
  gap: 48px;
}

.docs-footer-col {
  display: flex;
  flex-direction: column;
  gap: 8px;
}

.docs-footer-col h6 {
  margin: 0 0 4px;
  font-size: 11px;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--docs-text-muted);
}

.docs-footer-col a {
  font-size: 13px;
  color: var(--docs-text-secondary);
  text-decoration: none;
}

.docs-footer-col a:hover {
  color: var(--docs-primary);
}

.docs-footer-legal {
  display: flex;
  flex-wrap: wrap;
  gap: 20px;
  align-items: center;
  margin-top: 40px;
  padding-top: 20px;
  border-top: 1px solid var(--docs-border);
  font-size: 12px;
  color: var(--docs-text-muted);
}

.docs-footer-legal a {
  color: var(--docs-text-muted);
  text-decoration: none;
}

.docs-footer-legal a:hover {
  color: var(--docs-primary);
}

@media (max-width: 1024px) {
  .docs-footer {
    margin-left: 0;
    padding: 40px 24px 24px;
  }

  .docs-footer-inner {
    gap: 32px;
  }

  .docs-footer-nav {
    gap: 32px;
  }
}