/* docs.css — Documentación pública de la API de Actívate con Telcel.
 *
 * Familia visual: la del Panel de Control de Actívate («La Sala de Lectura», planes-admin/DESIGN.md) con la cabecera de marca de
 * la landing (planes-ui/DESIGN.md). Valores copiados POR VALOR de admin.css y pln-tokens.css, nunca cargados en runtime: esta
 * superficie es pública y no depende de ningún CDN ni servicio.
 *   · Material claro (negatoscopio) por defecto; el oscuro se elige o sigue al sistema. Mismas reglas, otros valores.
 *   · Cero sombras: la profundidad es escalón de valor y fili de 1px.
 *   · El azul Telcel (campo) vive SOLO en la cabecera, como la marca vive en el logo; el instrumento tiene su propia voz: el violeta.
 *   · Archivo para lectura, JetBrains Mono para rutas, códigos, etiquetas y toda cifra (tabulares).
 *   · El color nunca es el único portador de un dato: el método HTTP lleva su texto; el punto solo refuerza.
 */

@font-face { font-family: 'Archivo'; src: url('fonts/archivo-latin.woff2') format('woff2'); font-weight: 100 900; font-style: normal; font-display: swap; }
@font-face { font-family: 'JetBrains Mono'; src: url('fonts/jetbrains-mono-latin.woff2') format('woff2'); font-weight: 100 800; font-style: normal; font-display: swap; }

:root {
  /* Material claro — negatoscopio */
  --void: #F2F4F8;
  --panel: #FFFFFF;
  --raised: #E8EBF0;
  --line: #D0D5E0;
  --line-soft: #E8EBF0;
  --ink: #0E1117;
  --ink2: #3A4055;
  --ink3: #4A5268;

  --tool: #6340E0;          /* violeta 600: acción y selección */
  --tool-deep: #4A2EB8;
  --tool-ink: #FFFFFF;
  --tool-wash: rgba(125, 83, 255, .12);

  --stat: #994000;          /* ámbar de guardia (texto) */
  --stat-mark: #FF6B00;
  --stat-wash: rgba(255, 107, 0, .13);
  --signed: #6D9900;
  --signed-mark: #91CC00;
  --signed-wash: rgba(145, 204, 0, .20);
  --reject: #B01B1B;
  --reject-mark: #DC2626;
  --reject-wash: rgba(220, 38, 38, .12);
  --info: #4A2EB8;
  --info-wash: rgba(125, 83, 255, .13);
  --cyan: #007399;
  --cyan-mark: #00C2FF;
  --cyan-wash: rgba(0, 194, 255, .13);

  /* Cabecera de marca (landing de Actívate) */
  --field: #003087;
  --field-deep: #001D51;
  --field-ink: #FFFFFF;
  --field-ink-muted: rgba(255, 255, 255, .72);
  --accent-on-field: #D79BF2;
  --warm-on-field: #FFDE00;

  --sans: 'Archivo', system-ui, -apple-system, sans-serif;
  --mono: 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, monospace;

  --r-mark: 4px;
  --r-control: 8px;
  --r-card: 12px;
  --r-pill: 999px;

  --rail: 248px;
  --measure: 62rem;
}

:root[data-theme='dark'] {
  --void: #0E1117;
  --panel: #161B24;
  --raised: #242834;
  --line: #2E3445;
  --line-soft: #1C2130;
  --ink: #F2F4F8;
  --ink2: #9BA4BC;
  --ink3: #6B7494;

  --tool: #7D53FF;
  --tool-deep: #B191FF;
  --tool-ink: #0E1117;
  --tool-wash: rgba(125, 83, 255, .22);

  --stat: #FFA766;
  --signed: #C5FF33;
  --signed-mark: #B6FF00;
  --signed-wash: rgba(182, 255, 0, .18);
  --reject: #FF8F86;
  --reject-mark: #FF6B60;
  --reject-wash: rgba(255, 107, 96, .18);
  --info: #B191FF;
  --info-wash: rgba(125, 83, 255, .22);
  --cyan: #66DAFF;
  --cyan-wash: rgba(0, 194, 255, .20);
  --stat-wash: rgba(255, 107, 0, .20);
}

@media (prefers-color-scheme: dark) {
  :root:not([data-theme='light']) {
    --void: #0E1117; --panel: #161B24; --raised: #242834; --line: #2E3445; --line-soft: #1C2130;
    --ink: #F2F4F8; --ink2: #9BA4BC; --ink3: #6B7494;
    --tool: #7D53FF; --tool-deep: #B191FF; --tool-ink: #0E1117; --tool-wash: rgba(125, 83, 255, .22);
    --stat: #FFA766; --signed: #C5FF33; --signed-mark: #B6FF00; --signed-wash: rgba(182, 255, 0, .18);
    --reject: #FF8F86; --reject-mark: #FF6B60; --reject-wash: rgba(255, 107, 96, .18);
    --info: #B191FF; --info-wash: rgba(125, 83, 255, .22);
    --cyan: #66DAFF; --cyan-wash: rgba(0, 194, 255, .20); --stat-wash: rgba(255, 107, 0, .20);
  }
}

* { box-sizing: border-box; }
html { scroll-behavior: smooth; scroll-padding-top: 5rem; -webkit-text-size-adjust: 100%; }
body {
  margin: 0; background: var(--void); color: var(--ink2);
  font: 400 15px/1.6 var(--sans); font-variant-numeric: tabular-nums;
  -webkit-font-smoothing: antialiased;
}
a { color: var(--tool-deep); text-decoration-thickness: 1px; text-underline-offset: 2px; }
a:hover { color: var(--tool); }
:focus-visible { outline: 2px solid var(--tool); outline-offset: 2px; border-radius: var(--r-mark); }
::selection { background: var(--tool-wash); }

.skip { position: absolute; left: -999px; top: 0; background: var(--tool); color: var(--tool-ink); padding: .5rem .9rem; z-index: 50; border-radius: 0 0 var(--r-control) 0; }
.skip:focus { left: 0; }

/* ── Cabecera de marca ─────────────────────────────────────────────────────── */
.top { background: var(--field); color: var(--field-ink); border-bottom: 1px solid var(--field-deep); }
.top-in { max-width: calc(var(--rail) + var(--measure) + 4rem); margin: 0 auto; padding: 0 1.25rem; display: flex; align-items: center; gap: 1.25rem; min-height: 3.5rem; }
.brand { color: var(--field-ink); text-decoration: none; font-weight: 700; font-size: 15px; letter-spacing: -.005em; display: flex; align-items: baseline; gap: .6rem; }
.brand small { font: 500 11px/1 var(--mono); letter-spacing: .07em; text-transform: uppercase; color: var(--accent-on-field); }
.top nav { margin-left: auto; display: flex; gap: .25rem; flex-wrap: wrap; align-items: center; }
.top nav a { color: var(--field-ink-muted); text-decoration: none; font-size: 14px; padding: .35rem .7rem; border-radius: var(--r-control); }
.top nav a:hover { color: var(--field-ink); background: rgba(255, 255, 255, .1); }
.top nav a[aria-current='page'] { color: var(--field-ink); box-shadow: inset 0 -2px 0 var(--warm-on-field); border-radius: 0; }
.top :focus-visible { outline-color: var(--field-ink); }
.theme { margin-left: .25rem; background: transparent; border: 1px solid rgba(255, 255, 255, .55); color: var(--field-ink); font: 500 11px/1 var(--mono); letter-spacing: .07em; text-transform: uppercase; padding: .45rem .65rem; border-radius: var(--r-control); cursor: pointer; }
.theme:hover { background: rgba(255, 255, 255, .12); }

/* ── Estructura ────────────────────────────────────────────────────────────── */
.wrap { max-width: calc(var(--rail) + var(--measure) + 4rem); margin: 0 auto; padding: 2rem 1.25rem 4rem; display: grid; grid-template-columns: var(--rail) minmax(0, 1fr); gap: 2.5rem; align-items: start; }
.wrap.solo { grid-template-columns: minmax(0, 1fr); max-width: calc(var(--measure) + 4rem); }
.toc { position: sticky; top: 1rem; max-height: calc(100vh - 2rem); overflow: auto; border-left: 1px solid var(--line); padding: .25rem 0 .25rem 1rem; font-size: 13.5px; }
nav.toc h2 { font: 500 11px/1 var(--mono); letter-spacing: .07em; text-transform: uppercase; color: var(--ink3); margin: 0 0 .75rem; padding: 0; border: 0; }
.toc ol, .toc ul { list-style: none; margin: 0; padding: 0; }
.toc li { margin: 0; }
.toc a { display: block; color: var(--ink2); text-decoration: none; padding: .28rem .5rem; margin-left: -1rem; padding-left: calc(1rem - 2px); border-left: 2px solid transparent; }
.toc a:hover { color: var(--ink); background: var(--raised); }
.toc a.on { color: var(--ink); border-left-color: var(--tool); }
.toc .sub a { padding-left: calc(1.9rem - 2px); font-size: 13px; color: var(--ink3); }
main { min-width: 0; }

/* ── Tipografía de lectura ─────────────────────────────────────────────────── */
h1, h2, h3, h4 { color: var(--ink); font-weight: 600; line-height: 1.25; letter-spacing: -.01em; }
h1 { font-size: 30px; margin: 0 0 .75rem; letter-spacing: -.02em; }
h2 { font-size: 20px; margin: 3rem 0 .75rem; padding-top: 1.5rem; border-top: 1px solid var(--line); }
h2:first-of-type { margin-top: 2rem; }
h3 { font-size: 16px; margin: 2rem 0 .5rem; }
h2 .num { font: 500 13px/1 var(--mono); color: var(--ink3); margin-right: .55rem; letter-spacing: .02em; }
p { margin: 0 0 1rem; max-width: 70ch; }
ul, ol { margin: 0 0 1rem; padding-left: 1.3rem; max-width: 70ch; }
li { margin: .25rem 0; }
strong { color: var(--ink); font-weight: 600; }
.lead { font-size: 17px; color: var(--ink2); max-width: 62ch; margin-bottom: 1.5rem; }
.eyebrow { font: 500 11px/1 var(--mono); letter-spacing: .07em; text-transform: uppercase; color: var(--ink3); margin: 0 0 .75rem; }
.anchor { color: var(--ink3); text-decoration: none; margin-left: .4rem; opacity: 0; font-weight: 400; }
h2:hover .anchor, h3:hover .anchor, .anchor:focus { opacity: 1; }

code { font: 400 .88em/1.4 var(--mono); background: var(--raised); border: 1px solid var(--line-soft); padding: .08em .35em; border-radius: var(--r-mark); color: var(--ink); overflow-wrap: anywhere; }
pre { position: relative; margin: 0 0 1.25rem; background: var(--panel); border: 1px solid var(--line); border-radius: var(--r-control); padding: .9rem 1rem; overflow: auto; font: 400 12.5px/1.6 var(--mono); color: var(--ink); tab-size: 2; max-width: 100%; }
pre code { background: none; border: 0; padding: 0; font: inherit; color: inherit; overflow-wrap: normal; }
pre[data-lang]::before { content: attr(data-lang); position: absolute; top: .45rem; right: 4.6rem; font: 500 11px/1 var(--mono); letter-spacing: .07em; text-transform: uppercase; color: var(--ink3); }
.copy { position: absolute; top: .35rem; right: .45rem; font: 500 11px/1 var(--mono); letter-spacing: .07em; text-transform: uppercase; background: transparent; color: var(--ink2); border: 1px solid var(--line); border-radius: var(--r-mark); padding: .35rem .5rem; cursor: pointer; }
.copy:hover { color: var(--ink); background: var(--raised); }

/* ── Tablas: densas, filis, sin cebra ──────────────────────────────────────── */
.tw { overflow-x: auto; margin: 0 0 1.5rem; border: 1px solid var(--line); border-radius: var(--r-control); background: var(--panel); }
table { border-collapse: collapse; width: 100%; font-size: 13.5px; }
th { text-align: left; font: 500 11px/1.2 var(--mono); letter-spacing: .07em; text-transform: uppercase; color: var(--ink3); background: var(--void); padding: .6rem .8rem; border-bottom: 1px solid var(--line); white-space: nowrap; }
td { padding: .55rem .8rem; border-bottom: 1px solid var(--line-soft); vertical-align: top; color: var(--ink2); }
tr:last-child td { border-bottom: 0; }
td code { white-space: nowrap; }
td:first-child code { white-space: normal; }
.op-body td:first-child { white-space: nowrap; }
.op-body td:first-child .req { display: block; margin-top: .3rem; }

/* ── Método HTTP: píldora con texto + punto ────────────────────────────────── */
.m { display: inline-flex; align-items: center; gap: .4rem; font: 500 11px/1 var(--mono); letter-spacing: .05em; padding: .32rem .55rem; border-radius: var(--r-pill); color: var(--ink); white-space: nowrap; }
.m::before { content: ''; width: 7px; height: 7px; border-radius: 50%; background: currentColor; flex: none; }
.m.get { background: var(--cyan-wash); }  .m.get::before { background: var(--cyan-mark); }
.m.post { background: var(--signed-wash); } .m.post::before { background: var(--signed-mark); }
.m.patch { background: var(--info-wash); }  .m.patch::before { background: var(--tool); }
.p { font: 500 11px/1 var(--mono); letter-spacing: .05em; padding: .3rem .5rem; border-radius: var(--r-mark); border: 1px solid var(--line); color: var(--ink2); white-space: nowrap; background: var(--panel); }

/* ── Aviso (estado): tinte con texto saturado ──────────────────────────────── */
.note { border: 1px solid var(--line); background: var(--stat-wash); border-radius: var(--r-control); padding: .85rem 1rem; margin: 0 0 1.5rem; color: var(--ink); max-width: 72ch; }
.note p:last-child, .note ul:last-child { margin-bottom: 0; }
.note .eyebrow { color: var(--stat); margin-bottom: .4rem; display: flex; align-items: center; gap: .45rem; }
.note .eyebrow::before { content: ''; width: 7px; height: 7px; border-radius: 50%; background: var(--stat-mark); flex: none; }
.note.info { background: var(--info-wash); }
.note.info .eyebrow { color: var(--info); }
.note.info .eyebrow::before { background: var(--tool); }

/* ── Inicio ────────────────────────────────────────────────────────────────── */
.hero { padding: .5rem 0 0; }
.glance { display: grid; grid-template-columns: repeat(auto-fit, minmax(210px, 1fr)); gap: 1px; background: var(--line); border: 1px solid var(--line); border-radius: var(--r-card); overflow: hidden; margin: 0 0 2rem; }
.glance > div { background: var(--panel); padding: 1rem 1.1rem; }
.glance b { display: block; font: 500 11px/1 var(--mono); letter-spacing: .07em; text-transform: uppercase; color: var(--ink3); margin-bottom: .55rem; font-weight: 500; }
.glance span { display: block; color: var(--ink); font-size: 15px; line-height: 1.45; }
.glance span code { font-size: 12.5px; }
.steps { list-style: none; margin: 0 0 1.5rem; padding: 0; display: grid; grid-template-columns: repeat(auto-fit, minmax(190px, 1fr)); gap: .75rem; counter-reset: s; max-width: none; }
.steps li { margin: 0; background: var(--panel); border: 1px solid var(--line); border-radius: var(--r-card); padding: .8rem .9rem; counter-increment: s; position: relative; }
.steps li::before { content: counter(s, decimal-leading-zero); display: block; font: 500 11px/1 var(--mono); letter-spacing: .07em; color: var(--ink3); margin-bottom: .45rem; }
.steps li b { display: block; color: var(--ink); font-weight: 600; margin-bottom: .15rem; }
.steps li span { display: block; font-size: 13px; color: var(--ink2); line-height: 1.45; }
.steps li .p { margin-top: .5rem; display: inline-block; white-space: normal; overflow-wrap: anywhere; line-height: 1.4; }
.dl { display: grid; grid-template-columns: repeat(auto-fit, minmax(230px, 1fr)); gap: .75rem; margin: 0 0 1.5rem; }
.dl a { display: block; background: var(--panel); border: 1px solid var(--line); border-radius: var(--r-card); padding: .9rem 1rem; text-decoration: none; color: var(--ink); }
.dl a:hover { border-color: var(--tool); background: var(--raised); }
.dl a b { display: block; font-weight: 600; margin-bottom: .2rem; }
.dl a span { display: block; font-size: 13px; color: var(--ink2); }
.dl a small { display: block; margin-top: .5rem; font: 400 11.5px/1.4 var(--mono); color: var(--ink3); overflow-wrap: anywhere; }
.btn { display: inline-block; background: var(--tool); color: var(--tool-ink); padding: .55rem 1rem; border-radius: var(--r-control); text-decoration: none; font-weight: 600; font-size: 14px; }
.btn:hover { background: var(--tool-deep); color: var(--tool-ink); }
.btn.ghost { background: transparent; color: var(--ink2); border: 1px solid var(--line); }
.btn.ghost:hover { background: var(--raised); color: var(--ink); }
.cta { display: flex; gap: .6rem; flex-wrap: wrap; margin: 1.25rem 0 2.5rem; }

/* ── Referencia ────────────────────────────────────────────────────────────── */
.op { background: var(--panel); border: 1px solid var(--line); border-radius: var(--r-card); margin: 0 0 1.5rem; scroll-margin-top: 5rem; }
.op > header { display: flex; flex-wrap: wrap; align-items: center; gap: .6rem .8rem; padding: .85rem 1.1rem; border-bottom: 1px solid var(--line); }
.op > header .path { font: 500 13.5px/1.4 var(--mono); color: var(--ink); overflow-wrap: anywhere; }
.op > header .path em { font-style: normal; color: var(--tool-deep); }
.op > header h3 { margin: 0; flex-basis: 100%; font-size: 16px; }
.op-body { padding: 1rem 1.1rem 0; }
.op-body h4 { font: 500 11px/1 var(--mono); letter-spacing: .07em; text-transform: uppercase; color: var(--ink3); margin: 1.25rem 0 .55rem; }
.op-body h4:first-child { margin-top: 0; }
.op-body .tw { margin-bottom: 1.1rem; }
.sc { font: 500 11px/1.3 var(--mono); color: var(--ink2); }
.req { font: 500 11px/1 var(--mono); color: var(--stat); letter-spacing: .05em; text-transform: uppercase; }
.st { font: 500 12px/1 var(--mono); padding: .28rem .45rem; border-radius: var(--r-mark); color: var(--ink); background: var(--raised); }
.st.ok { background: var(--signed-wash); } .st.e4 { background: var(--stat-wash); } .st.e5 { background: var(--reject-wash); }

footer { border-top: 1px solid var(--line); margin-top: 3rem; padding: 1.5rem 0 0; font-size: 13px; color: var(--ink3); max-width: 70ch; }
footer p { margin-bottom: .4rem; }

@media (max-width: 880px) {
  .wrap { grid-template-columns: minmax(0, 1fr); gap: 1.25rem; padding-top: 1.25rem; }
  .toc { position: static; max-height: none; border: 1px solid var(--line); border-radius: var(--r-control); background: var(--panel); padding: .75rem 1rem; }
  .toc a { margin-left: 0; padding-left: .5rem; }
  .toc .sub a { padding-left: 1.4rem; }
  .toc ul { display: flex; flex-wrap: wrap; gap: .15rem .25rem; }
  .toc .sub { display: none; }
  .toc a { border: 1px solid var(--line); border-radius: var(--r-pill); padding: .25rem .65rem; }
  .toc a.on { border-color: var(--tool); }
  td code, .op-body td:first-child { white-space: normal; overflow-wrap: anywhere; }
  td { min-width: 7rem; }
  .top-in { flex-wrap: wrap; padding-top: .6rem; padding-bottom: .6rem; }
  .top nav { margin-left: 0; }
  h1 { font-size: 25px; }
  pre[data-lang]::before { display: none; }
}
@media (prefers-reduced-motion: reduce) { html { scroll-behavior: auto; } * { animation: none !important; transition: none !important; } }
@media print { .top, .toc, .copy, .theme { display: none; } .wrap { display: block; } body { background: #fff; color: #000; } }

.brand img { display: block; height: 21px; width: auto; }
.brand { align-items: center; }
.ver-chip { font: 500 11px/1 var(--mono); letter-spacing: .02em; text-transform: none; color: var(--field-ink); border: 1px solid var(--accent-on-field); border-radius: var(--r-control); padding: .18rem .4rem; margin-left: .35rem; }
.ver { margin: .25rem 0 1.25rem; color: var(--ink2, var(--ink3)); font-size: 14px; line-height: 1.5; }
.ver .ver-chip { color: var(--ink); border-color: var(--line); background: var(--panel); margin: 0 .4rem 0 0; }
#alcance + .tw th { text-align: left; white-space: nowrap; vertical-align: top; width: 9.5rem; }
@media (max-width: 640px) { .brand img { height: 18px; } #alcance + .tw th { white-space: normal; } }