Table of Contents

Anatomía CSS

<div class="toc">
  <span class="toc__label"></span>
  <span class="toc__link"></span>
  <span class="toc__list"></span>
</div>

Tokens resueltos

Valores finales tras seguir la cadena de tokens. Derivados del source: si un token cambia, esta tabla cambia sola.

Animaciones

CSS mínimo funcional

Autocontenido: sin imports ni tokens. Para previews y prototipos — en producción se consume el CSS del DS (@atom-uikit/css/components.css</code>, <code>@atom-uikit/tokens/tokens.css).

/* -------------------------------------------------------------------------
   Table of Contents

   Indice de un documento largo: rail de links generados desde los headings del
   contenido. A diferencia de `progress-nav` (secciones declaradas a mano, con
   indicador deslizante), aqui los links NO se escriben: el behavior
   `table-of-contents` de packages/animations los clona desde un template y
   marca el activo al hacer scroll.

   Contrato de estado (lo escribe el behavior, no el consumidor):
     [data-toc-status="active"]  link de la seccion visible
     [data-toc-depth="2|3|4"]    nivel del heading, para la indentacion

   El scroll-spy es el behavior; este archivo solo pinta el estado.
   ------------------------------------------------------------------------- */

.toc {
  display: flex;
  flex-direction: column;
  gap: 16px;
}

.toc__label {
  color: #525252;
}

.toc__list {
  display: flex;
  flex-direction: column;
}

.toc__link {
  display: block;
  padding-block: 8px;
  padding-inline: 16px 8px;
  /* El rail es un borde por link, no un borde en la lista: asi el tramo activo
     se pinta sin que un pseudo-elemento tenga que medir posiciones. */
  border-inline-start: 1.5px solid #e5e5e5;
  color: #525252;
  font-family: 'inter tight', -apple-system, blinkmacsystemfont, 'segoe ui', roboto, helvetica, arial, sans-serif;
  font-size: 12.8px;
  line-height: 1.45;
  text-decoration: none;
  text-wrap: pretty;
  /* Un heading legal puede traer una palabra larguisima o una URL: en un rail de
     15rem tiene que partir, no sobresalir. */
  overflow-wrap: break-word;
  transition:
    color 200ms cubic-bezier(0.22, 1, 0.36, 1),
    border-color 200ms cubic-bezier(0.22, 1, 0.36, 1);
}

@media (hover: hover) and (pointer: fine) {
  .toc__link:hover {
    color: #0a0a0a;
    border-inline-start-color: #525252;
  }
}

.toc__link[data-toc-status='active'] {
  color: #0a0a0a;
  font-weight: 500;
  /* Naranja de marca como acento fino: 1.5px de rail, jamas relleno ni texto. */
  border-inline-start-color: #ff6600;
}

.toc__link:focus-visible {
  outline: 2px solid #0a0a0a;
  outline-offset: 1.5px;
  border-radius: 4px;
}

/* ---- Profundidad ----
   Se indenta el padding, no el margen: el rail (borde) debe quedar alineado en
   todos los niveles, si no la linea se rompe en cada sub-seccion. */

.toc__link[data-toc-depth='3'] {
  padding-inline-start: calc(16px + 16px);
}

.toc__link[data-toc-depth='4'] {
  padding-inline-start: calc(16px + 32px);
}

/* ---- Colapsado (movil) ----
   En pantallas angostas el indice no puede ocupar media pantalla antes del
   texto. `<details class="toc toc--collapsible">` lo cierra sin JS.  */

.toc--collapsible > summary {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 8px;
  cursor: pointer;
  list-style: none;
  color: #525252;
}

.toc--collapsible > summary::-webkit-details-marker {
  display: none;
}

.toc--collapsible > summary::after {
  content: '';
  width: 0.5em;
  height: 0.5em;
  border-inline-end: 1.5px solid currentColor;
  border-block-end: 1.5px solid currentColor;
  rotate: 45deg;
  transition: rotate 200ms cubic-bezier(0.22, 1, 0.36, 1);
}

.toc--collapsible[open] > summary::after {
  rotate: 225deg;
}

.toc--collapsible > summary:focus-visible {
  outline: 2px solid #0a0a0a;
  outline-offset: 1.5px;
}

@media (prefers-reduced-motion: reduce) {
  .toc__link,
  .toc--collapsible > summary::after {
    transition-duration: 0ms;
  }
}