Higinio Celeste Clásica · v2.0

Sistema de diseño · Higinio Sosa

Celeste Clásica

Sistema de marca light-first, sereno y confiable, para todos los productos de software de Higinio Sosa: web apps, dashboards, landing pages y móvil. La elegancia viene del orden y el aire, no de la decoración.

01

Claridad primero

El contenido siempre por encima de la decoración.

02

Calma visual

Superficies claras, whitespace generoso, contraste solo donde importa.

03

Un acento a la vez

El azul acero guía la acción; nunca compite consigo mismo.

04

Consistencia sobre novedad

Mismos tokens en todos los productos; cero valores mágicos.

05

Movimiento con propósito

La animación explica — aparece, cambia, desaparece — nunca decora sola.

Regla de oro

Los componentes consumen solo tokens semánticos (--surface, --accent, --link…), nunca hex directos. El cambio de tema es un atributo, no un refactor.

Fundamentos

Voz y contenido

Una consultora seria pero cálida — "banca privada boutique", no "startup ruidosa".

ReglaNo
Idioma: español LatAm neutro, de "tú"Guarda tus cambiosGuarde usted los cambios
Sentence case en todoEliminar cuentaEliminar Cuenta / ELIMINAR
Botones imperativos de 1–3 palabrasGuardarGuardando los cambios ahora
Errores accionablesEl correo no tiene un formato válido. Revísalo.Error
Sin exclamaciones ni emojiCuenta creada¡Cuenta creada! 🎉
Voz en segunda personaTus proyectosNuestros proyectos para ti

Fundamentos

Colores

Un solo acento — azul acero #7192ba — sobre neutrales grisáceo-azulados derivados de la tinta #31343e. Haz clic en cualquier muestra para copiar su variable.

Primario — Azul acero

Neutrales — Gris azulado

Semánticos — ramp de 3 tonos

Cada estado tiene el sólido (-500), el fondo suave (-100) y el tono de texto AA sobre ese fondo (-text).

Aliases semánticos

Los componentes consumen solo esta capa — así el cambio de tema es un cambio de atributo.

AliasValor (light)Rol

Regla AA del acento

primary-500 sobre blanco da ~3:1 — válido solo para componentes UI (rellenos, bordes, focus). Para texto (links, botones ghost) usa --link = primary-700 (~6:1). primary-300 jamás como texto.

Proporción 60-30-10

60% neutrales claros
30% tinta y estructura
10%

Un solo botón primario visible por pantalla; el resto secundarios o ghost. Fondos siempre planos: sin gradientes, texturas ni patrones. El acento pierde poder si supera el 10 %.

Fundamentos

Tipografía

Tres familias con roles estrictos. Escala 1.25 (tercera mayor) desde 16 px.

Fraunces

Ag Serena

Display 600–700 · solo h1–h2, cifras hero y marketing. Nunca UI ni párrafos.

Public Sans

Ag Clara

Body/UI 400–600 · párrafos, botones, formularios, h3–h6. Todo lo demás.

IBM Plex Mono

0123.45

Mono 400–500 · datos numéricos, código, IDs, montos en tablas.

Escala

Tracking: -0.02em en display ≥31px · 0 en body · +0.04em en labels uppercase. Longitud de línea máx. 65ch. Números en tablas con tabular-nums. Mínimo absoluto 12 px.

Fundamentos

Espaciado

Escala base 4 px — cero valores mágicos. El número del token = px ÷ 4.

Aliases de uso

AliasValorUso
--card-padding24pxPadding de tarjetas (16px en móvil)
--section-gap64pxSeparación entre secciones
--form-gap20pxGap entre campos de formulario
--button-padding-md12px 20pxBotón md (sm: 8px 14px)
--control-height-*36 / 44 / 52Alturas de controles sm / md / lg
--gutter24pxGutter del grid de 12 columnas (16px móvil)

Fundamentos

Bordes, radios y focus

Bordes de 1 px, radios generosos y un focus siempre visible — la geometría que sostiene la calma de la marca.

Radios

sm · 6
md · 10
lg · 14
xl · 20
full

Borde por defecto 1px solid var(--border). Focus ring global de teclado: 2px var(--primary-500) con offset 2px vía :focus-visible — el click de ratón no lo dispara. Único uso de transparencia: overlay de modal y ring de focus. No hay blur ni glassmorphism en Celeste Clásica.

Fundamentos

Elevación

Sombras frías teñidas con la tinta rgba(49,52,62,…), nunca negro puro. Máximo 3 niveles de elevación visibles por pantalla. Sin resplandor de acento: el glow es exclusivo de Nocturna Eléctrica.

Niveles

Nivel 0
reposo · sin sombra
Nivel 1
shadow-xs/sm · inputs, tarjetas
Nivel 2
shadow-md · hover, dropdowns
Nivel 3
shadow-lg/xl · modales, diálogos

Sombras

xs
sm
md
lg
xl

Fundamentos

Iconografía

Set sustituto: Lucide — trazo 1.5–2 px, esquinas redondeadas, geométrico. Si existe un set propio de marca, reemplazar.

home
search
bell
user
folder
chart

Fundamentos

Marca / wordmark

No hay logo ni imágenes de marca. Donde un mockup necesite logotipo se renderiza «Higinio» (o el nombre del producto) en --font-display (Fraunces) — nunca se dibuja un logo aproximado.

Higinio Higinio

Biblioteca

Componentes

Los 35 componentes del sistema, renderizados en vivo con las clases del framework celeste-clasica.css. Cada bloque incluye su código de uso.

Botones

Alturas 36 / 44 / 52 px · radius md · peso 600 · un solo primario visible por pantalla. Ghost y outline usan --link (AA), no primary-500.

Ver código
<button class="btn btn--primary">Guardar cambios</button>
<button class="btn btn--secondary">Cancelar</button>
<button class="btn btn--outline">Exportar</button>
<button class="btn btn--ghost">Ver detalles</button>
<button class="btn btn--danger">Eliminar cuenta</button>

<!-- Tamaños: btn--sm · (md por defecto) · btn--lg -->
<button class="btn btn--primary btn--lg">Grande</button>

IconButton

Botón cuadrado solo-icono para toolbars y chrome. Default ghost. Siempre con aria-label.

Ver código
<button class="icon-btn icon-btn--ghost" aria-label="Buscar">
  <svg>…icono 18px…</svg>
</button>
<!-- Variantes: --ghost (default) · --secondary · --primary
     Tamaños: --sm 32px · (md 40px) · --lg 48px -->

Spinner

Trazo 2.5, rotación 0.8 s linear. Si la carga dura <300 ms, no mostrar spinner. Blanco dentro de botones primarios.

Ver código
<svg class="spinner" viewBox="0 0 24 24" fill="none">
  <circle cx="12" cy="12" r="9" stroke="currentColor" stroke-width="2.5"/>
  <path d="M21 12a9 9 0 0 0-9-9" stroke="currentColor"
        stroke-width="2.5" stroke-linecap="round"/>
</svg>

Input

Altura 44 px · label siempre visible (nunca placeholder como label) · focus con borde --accent + ring · obligatorio con .field--required (asterisco --danger + required/aria-required).

Nunca compartiremos tu correo.
La contraseña necesita al menos 8 caracteres. Agrega más.
Ver código
<div class="field">
  <label class="field__label" for="correo">Correo electrónico</label>
  <input class="input" id="correo" type="email" placeholder="tu@correo.com">
  <span class="field__help">Nunca compartiremos tu correo.</span>
</div>

<!-- Obligatorio: .field--required en el .field + required/aria-required en el input -->
<div class="field field--required">
  <label class="field__label" for="nombre">Nombre completo</label>
  <input class="input" id="nombre" required aria-required="true">
</div>

<!-- Estados: input--error (+ .field__error) · input--success · disabled
     Icono leading: envolver en .input-icon -->

Textarea

Min-height 96 px · resize: vertical · contador opcional alineado a la derecha.

0 / 200
Ver código
<div class="field">
  <label class="field__label" for="desc">Descripción</label>
  <textarea class="textarea" id="desc" maxlength="200"></textarea>
  <span class="textarea-counter">0 / 200</span>
</div>

Select

Trigger igual que input + chevron 16 px que rota al abrir. Menú con shadow-lg y opción seleccionada en --accent-soft.

Ver código
<div class="select-wrap">
  <select class="select">
    <option>Ciudad de México (GMT-6)</option>
    <option>Bogotá (GMT-5)</option>
  </select>
</div>

SegmentedControl

2–4 opciones mutuamente excluyentes. Indicador blanco con shadow-xs. Para más de 4 opciones, usar Select.

Ver código
<div class="segmented" role="radiogroup" aria-label="Vista">
  <input type="radio" name="vista" id="lista" checked><label for="lista">Lista</label>
  <input type="radio" name="vista" id="tablero"><label for="tablero">Tablero</label>
</div>
<!-- Compacto: añadir segmented--sm -->

Slider

Track 6 px con porción rellena en --accent · thumb blanco 18 px con borde de acento que escala 1.15 al presionar.

Límite de gasto $ 350
Ver código
<div class="slider-row">
  <span class="slider-label">Límite de gasto</span>
  <span class="slider-value">$ 350</span>
</div>
<input class="slider" type="range" min="0" max="1000" value="350">
<!-- JS: actualizar --slider-fill = ((v-min)/(max-min))*100 + '%' -->

Checkbox y Radio

20 px · borde 2 px · check que se dibuja con ease-spring · label clicable con gap 10 px · estado indeterminate (guion) para «seleccionar todo» parcial.

Ver código
<label class="checkbox">
  <input type="checkbox" checked>
  <span class="checkbox__box">
    <svg viewBox="0 0 24 24"><path d="M20 6 9 17l-5-5"/></svg>
  </span>
  Recibir novedades
</label>

<label class="radio">
  <input type="radio" name="plan" checked>
  <span class="radio__dot"></span>
  Plan mensual
</label>

<!-- Indeterminate: propiedad del DOM, no atributo HTML -->
<!-- checkbox.indeterminate = true (guion horizontal) -->

Switch

Track 44×24 px · thumb 20 px que desliza 20 px en 200 ms ease-spring.

Ver código
<label class="switch">
  <input type="checkbox" checked>
  <span class="switch__track"></span>
  Notificaciones
</label>

Badge y Tag

Fondo suave semántico (*-100) + texto --*-text (AA garantizado). Estado nunca solo con color: color + icono + texto.

Borrador Activo Pendiente Vencido Beta
diseño frontend urgente
Ver código
<span class="badge badge--success">
  <svg>…icono…</svg>Activo
</span>
<!-- Tonos: (neutral) · --success · --warning · --danger · --info -->

<span class="tag">diseño
  <button class="tag__close" aria-label="Quitar etiqueta">
    <svg>…x…</svg>
  </button>
</span>

Avatar

Fallback automático a iniciales sobre chip primary-100. Dot de presencia: 28 % del diámetro con anillo de superficie.

HS HS MG AL HS MG AL RD
Ver código
<span class="avatar avatar--lg">
  <span class="avatar__initials">HS</span>
  <i class="avatar__dot avatar__dot--online"></i>
</span>
<!-- Tamaños: --sm 28 · (md 36) · --lg 48 · --xl 64
     Presencia: --online · --busy · --away · (offline) -->

AvatarGroup

Stack de avatares solapados (-8px) con anillo 2 px de --surface que los separa · avatar-group__more para el +N de overflow.

HS MG AL RD +3
Ver código
<div class="avatar-group">
  <span class="avatar"><span class="avatar__initials">HS</span></span>
  <span class="avatar"><span class="avatar__initials">MG</span></span>
  <span class="avatar"><span class="avatar__initials">AL</span></span>
  <span class="avatar"><span class="avatar__initials">RD</span></span>
  <span class="avatar-group__more">+3</span>
</div>
<!-- Solape -8px · cada avatar con anillo 2px de --surface -->

Divider

Regla hairline 1 px --border · variante con label centrado (patrón "o continúa con") · vertical para flex.


FiltrosOrdenarExportar
Ver código
<hr class="divider">
<div class="divider--label" role="separator">o continúa con</div>
<span class="divider--vertical" role="separator"></span>

Accordion

Altura animada con grid-template-rows 0fr→1fr (sin reflow) · chevron rota 180° · aria-expanded.

Sí. El cambio se aplica de inmediato y el cobro se prorratea según los días restantes del ciclo.
Desde Ajustes → Datos puedes descargar todo en CSV o JSON. El archivo llega a tu correo en unos minutos.
Tu cuenta queda en pausa 30 días por si cambias de opinión. Después, los datos se eliminan de forma permanente.
Ver código
<div class="accordion">
  <div class="accordion__item is-open">
    <button class="accordion__header" aria-expanded="true">
      Pregunta <svg>…chevron…</svg>
    </button>
    <div class="accordion__panel"><div>
      <div class="accordion__content">Respuesta</div>
    </div></div>
  </div>
</div>
<!-- JS: alternar .is-open en .accordion__item + aria-expanded -->

Tooltip

Delay 400 ms · fade + translateY(4→0) · máx. 1 línea; si necesita más, usar popover. Pasa el cursor por los botones.

Ver código
<button class="btn btn--secondary" data-tooltip="Duplica el proyecto">
  Duplicar
</button>
<!-- Solo CSS: atributo data-tooltip. Fondo se invierte en dark. -->

Alert

Banner inline y persistente (vs Toast, transitorio). Icono *-500 + texto --*-text sobre fondo *-100. role="status".

Nueva versión disponible

La versión 2.4 incluye exportación a PDF. Actualiza cuando quieras.

Pago confirmado

El recibo se envió a tu correo.

Tu plan expira en 5 días

Renueva antes del 12 de julio para no perder acceso.

No se pudo guardar el formulario

Revisa los campos marcados en rojo e inténtalo de nuevo.

Ver código
<div class="alert alert--warning" role="status">
  <svg>…icono…</svg>
  <div>
    <p class="alert__title">Tu plan expira en 5 días</p>
    <p class="alert__body">Renueva antes del 12 de julio.</p>
  </div>
  <button class="alert__close" aria-label="Cerrar aviso">…x…</button>
</div>
<!-- Tonos: --info · --success · --warning · --danger -->

Toast

Top-right (desktop) · 360 px · borde izquierdo 3 px semántico · auto-dismiss 5 s pausable con hover · máx. 3 apilados.

Ver código
<div class="toast-stack" role="status" aria-live="polite">
  <div class="toast toast--success">
    <svg>…icono…</svg>
    <div>
      <p class="toast__title">Cambios guardados</p>
      <p class="toast__body">El proyecto se actualizó.</p>
    </div>
    <button class="icon-btn icon-btn--ghost icon-btn--sm" aria-label="Cerrar">…x…</button>
  </div>
</div>

Progress y ProgressRing

Solo progreso determinado — para carga indeterminada usar Skeleton. Width / dashoffset animan 250 ms.

Almacenamiento68%
Tareas completadas24/30
68%
Ver código
<div class="progress-row">
  <span class="progress-label">Almacenamiento</span>
  <span class="progress-value">68%</span>
</div>
<div class="progress">
  <div class="progress__bar" style="width:68%"
       role="progressbar" aria-valuenow="68"
       aria-valuemin="0" aria-valuemax="100"></div>
</div>
<!-- Tonos de barra: (accent) · --success · --warning · --danger -->

Modal

role="dialog" · aria-modal · aria-labelledby + aria-describedby · al abrir el foco entra al panel, queda atrapado (Tab/Shift+Tab ciclan) y vuelve al disparador al cerrar · Esc y click en overlay cierran, salvo flujos destructivos (el de confirmación no cierra por overlay).

Ver código
<div class="modal" id="miModal" role="dialog" aria-modal="true"
     aria-labelledby="miModalTitulo" aria-describedby="miModalDesc">
  <!-- overlay sin data-modal-close en flujos destructivos -->
  <div class="modal__overlay" data-modal-close></div>
  <div class="modal__panel" tabindex="-1">
    <div class="modal__header">
      <h4 class="modal__title" id="miModalTitulo">¿Eliminar proyecto?</h4>
      <button class="icon-btn icon-btn--ghost" data-modal-close aria-label="Cerrar">…x…</button>
    </div>
    <p id="miModalDesc">Esta acción no se puede deshacer.</p>
    <div class="modal__footer">
      <button class="btn btn--secondary" data-modal-close>Cancelar</button>
      <button class="btn btn--danger">Eliminar</button>
    </div>
  </div>
</div>
<!-- Panel ancho: modal__panel--lg (640px) -->
<!-- JS: al abrir guarda el disparador y enfoca el panel; Tab/Shift+Tab
     atrapados dentro; al cerrar (Esc, ×, Cancelar) el foco vuelve al disparador -->

Menu

Panel 190 px mín. con shadow-lg · entrada fade + translateY(-4→0) 160 ms · ítem danger con hover danger-100.

Ver código
<div class="menu-wrap">
  <button class="btn btn--secondary">Acciones</button>
  <div class="menu" role="menu">
    <button class="menu__item" role="menuitem">…Editar</button>
    <div class="menu__sep" role="separator"></div>
    <button class="menu__item menu__item--danger" role="menuitem">…Eliminar</button>
  </div>
</div>
<!-- JS: alternar .is-open; cerrar con click fuera, Esc o al seleccionar -->

Tabla

Header uppercase +0.04em · filas 52 px · numéricos a la derecha con tabular-nums. Variantes: .table--zebra · .table--sticky (header fijo) · columna ordenable con aria-sort · selección con .row--selected y «seleccionar todo» indeterminate.

Cliente Estado
Constructora Delta Activo $ 48,200.00
Grupo Andrade Pendiente $ 9,850.00
Studio Nébula Activo $ 132,400.00
Farmacias Luna Vencido $ 1,120.00
Ver código
<table class="table table--zebra table--sticky">
  <thead>
    <tr>
      <th class="col-select" scope="col">
        <label class="checkbox"><input type="checkbox" aria-label="Seleccionar todo">
          <span class="checkbox__box"><svg>…check…</svg></span></label>
      </th>
      <th scope="col">Cliente</th>
      <th class="num" scope="col" aria-sort="none">
        <button class="th-sort th-sort--num" data-sort="monto">
          Monto<svg class="sort-icon" aria-hidden="true">…</svg></button>
      </th>
    </tr>
  </thead>
  <tbody>
    <tr class="row--selected">
      <td class="col-select"><label class="checkbox"><input type="checkbox" checked
        aria-label="Seleccionar Grupo Andrade">…</label></td>
      <td>Grupo Andrade</td><td class="num" data-monto="9850">$ 9,850.00</td>
    </tr>
  </tbody>
</table>
<!-- JS: click en .th-sort alterna aria-sort asc/desc y reordena tbody;
     el checkbox del header pasa a indeterminate con selección parcial -->

Stat

KPI único, componer dentro de Card. Valor en mono text-3xl · delta con flecha en tonos --*-text · count-up al entrar en viewport.

Ingresos del mes
$ 0 +12.4%
Clientes activos
0 -2.1%
Proyectos abiertos
0 0%
Ver código
<div class="card">
  <div class="stat">
    <span class="stat__label"><svg>…</svg>Ingresos del mes</span>
    <div class="stat__row">
      <span class="stat__value">$ 128,400</span>
      <span class="stat__delta stat__delta--up"><svg>…</svg>+12.4%</span>
    </div>
  </div>
</div>
<!-- Delta: --up (success-text) · --down (danger-text) · neutro (text-muted) -->

Pagination

1-indexado, bajo una tabla · trunca con elipsis a partir de 7 páginas · página activa como chip sólido con aria-current="page".

    Ver código
    <ul class="pagination" aria-label="Paginación">
      <li><button class="pagination__btn" aria-label="Anterior">…‹…</button></li>
      <li><button class="pagination__btn">1</button></li>
      <li><span class="pagination__ellipsis">…</span></li>
      <li><button class="pagination__btn is-active" aria-current="page">5</button></li>
      <li><button class="pagination__btn">6</button></li>
      <li><button class="pagination__btn" aria-label="Siguiente">…›…</button></li>
    </ul>

    Navegación

    Navbar 64 px · sidebar 260 px · tabs con indicador de 2 px · breadcrumbs con separador / tipográfico.

    Vista general del proyecto con sus métricas clave.
    Ver código
    <nav class="navbar">
      <a class="navbar__brand" href="/">Higinio</a>
      <div class="navbar__nav">
        <a class="navbar__link is-active" href="#">Resumen</a>
        <a class="navbar__link" href="#">Proyectos</a>
      </div>
    </nav>
    
    <nav class="sidebar">
      <button class="sidebar__item is-active"><svg>…</svg>Inicio</button>
    </nav>
    
    <div class="tabs" role="tablist">
      <button class="tabs__tab is-active" role="tab">Resumen</button>
    </div>
    
    <nav class="breadcrumbs">
      <a href="#">Inicio</a><span class="breadcrumbs__sep">/</span>
      <span class="breadcrumbs__current">Panel</span>
    </nav>

    Skeleton y EmptyState

    Shimmer 1.4 s en loop, radius igual al contenido que reemplaza. Un estado vacío siempre invita a actuar.

    Aún no tienes proyectos

    Crea tu primer proyecto para empezar a organizar tu trabajo.

    Ver código
    <div class="skeleton" style="height:10px;width:85%"></div>
    <div class="skeleton skeleton--circle" style="width:40px;height:40px"></div>
    
    <div class="empty-state">
      <svg>…icono 40px…</svg>
      <p class="empty-state__title">Aún no tienes proyectos</p>
      <p class="empty-state__desc">Crea tu primer proyecto para empezar.</p>
      <button class="btn btn--primary">Crear proyecto</button>
    </div>

    Card, Link y Code

    Tarjeta con padding 24 px y shadow-sm; la interactiva sube 2 px al hover. Link con subrayado que crece. Code inline en mono.

    Tarjeta estática

    Contenido en reposo con borde --border y shadow-sm.

    Tarjeta interactiva

    Pasa el cursor: sube 2 px con shadow-md. Consulta la guía de motion.

    Ver código
    <div class="card">…</div>
    <div class="card card--interactive">…</div>
    
    <a class="link" href="#">Enlace con subrayado animado</a>
    <span class="code">--accent</span>

    Combobox y búsqueda

    role="combobox" · aria-expanded + aria-controls + aria-activedescendant · lista role="listbox", opciones role="option" · ↑/↓ mueven, Enter elige, Esc cierra, Home/End a extremos. La búsqueda se limpia con la ×.

      Ver código
      <div class="combobox">
        <input class="combobox__input" type="text" role="combobox"
          aria-expanded="false" aria-controls="lista" aria-autocomplete="list"
          aria-activedescendant="opt-0" autocomplete="off">
        <ul class="combobox__list" id="lista" role="listbox" aria-label="Ciudades">
          <li class="combobox__option is-active" role="option" id="opt-0"
              aria-selected="false">Guadalajara</li>
          <li class="combobox__option" role="option" id="opt-1"
              aria-selected="true">Monterrey
            <svg class="combobox__check">…check…</svg></li>
        </ul>
      </div>
      
      <div class="search">
        <svg class="search__icon" aria-hidden="true">…lupa…</svg>
        <input class="search__input" type="search" placeholder="Buscar…">
        <button class="search__clear" aria-label="Limpiar">…x…</button>
      </div>

      Drawer / Sheet

      role="dialog" · aria-modal · foco atrapado y devuelto al disparador (patrón del Modal) · overscroll-behavior: contain · entra deslizando desde el borde y sale más corto · Esc y click en overlay cierran. Variantes --right (default), --left, --bottom.

      Ver código
      <div class="drawer drawer--right" id="miDrawer" role="dialog"
           aria-modal="true" aria-labelledby="miDrawerTitulo">
        <div class="drawer__overlay" data-drawer-close></div>
        <div class="drawer__panel" tabindex="-1">
          <div class="drawer__header">
            <h4 class="drawer__title" id="miDrawerTitulo">Filtrar proyectos</h4>
            <button class="icon-btn icon-btn--ghost" data-drawer-close aria-label="Cerrar">…x…</button>
          </div>
          <!-- campos… -->
          <div class="drawer__footer">
            <button class="btn btn--secondary" data-drawer-close>Cancelar</button>
            <button class="btn btn--primary" data-drawer-close>Aplicar</button>
          </div>
        </div>
      </div>

      Popover

      Se abre por click (no hover, a diferencia del tooltip) y lleva contenido interactivo · trigger aria-haspopup="dialog" + aria-expanded · panel role="dialog" · aparece desde el trigger (fade + scale 0.96→1) · Esc y click fuera cierran.

      Ver código
      <div class="popover">
        <button class="btn btn--secondary popover__trigger"
                aria-haspopup="dialog" aria-expanded="false"
                aria-controls="pop">Detalles del plan</button>
        <div class="popover__panel" id="pop" role="dialog"
             aria-label="Detalles del plan" tabindex="-1">
          <p>Contenido con <a class="link" href="#">un enlace</a>.</p>
        </div>
      </div>

      ButtonGroup

      Botones adyacentes con bordes compartidos (radius solo en los extremos, bordes internos colapsados) · role="group" + aria-label · usa los .btn existentes. Para un único-seleccionado, usa SegmentedControl.

      Ver código
      <div class="btn-group" role="group" aria-label="Navegación de semana">
        <button class="btn btn--secondary">Anterior</button>
        <button class="btn btn--secondary">Hoy</button>
        <button class="btn btn--secondary">Siguiente</button>
      </div>

      DatePicker

      Input + calendario en popover · rejilla role="grid", encabezados role="columnheader" con aria-label completo, días role="gridcell" con aria-label de la fecha entera y aria-selected · las flechas mueven entre días · el input abre el calendario (click), Esc cierra y el foco entra al calendario · hoy marcado y un día seleccionado.

      Ver código
      <div class="datepicker">
        <input class="datepicker__input" type="text" readonly
               aria-haspopup="dialog" aria-expanded="false" aria-controls="cal">
        <svg class="datepicker__icon" aria-hidden="true">…calendario…</svg>
        <div class="datepicker__calendar" id="cal" role="dialog"
             aria-label="Elegir fecha" tabindex="-1">
          <div class="calendar">
            <div class="calendar__header">
              <button aria-label="Mes anterior">…</button>
              <span class="calendar__title">julio 2026</span>
              <button aria-label="Mes siguiente">…</button>
            </div>
            <div class="calendar__weekdays" role="row">
              <span class="calendar__weekday" role="columnheader"
                    aria-label="lunes">lu</span> …
            </div>
            <div class="calendar__grid" role="grid" aria-label="julio 2026">
              <button class="calendar__day calendar__day--today" role="gridcell"
                      aria-label="viernes, 10 de julio de 2026"
                      aria-selected="false">10</button>
              <button class="calendar__day calendar__day--selected" role="gridcell"
                      aria-label="viernes, 17 de julio de 2026"
                      aria-selected="true">17</button> …
            </div>
          </div>
        </div>
      </div>

      FileUpload

      Dropzone + lista · el input file real va oculto pero con label asociado y aria-describedby de formatos y tamaño · la zona describe la acción · estado .is-dragover al arrastrar · el error no se comunica solo por color (icono + texto) · el item que sube reusa la barra .progress.

      • informe-anual-2026.pdf 2.4 MB · Subiendo 45%
      • portada.png 820 KB · Completo
      • video-demo.mov Formato no admitido · elige PDF, PNG o JPG
      Ver código
      <div class="file-upload">
        <input class="file-upload__input" type="file" multiple
               aria-describedby="hint">
        <label class="file-upload__label" for="…">
          <svg aria-hidden="true">…subir…</svg>
          <span class="file-upload__title">Arrastra archivos o elige</span>
          <span class="file-upload__button">Elegir archivos</span>
          <span class="file-upload__hint" id="hint">PDF, PNG o JPG · hasta 10 MB</span>
        </label>
      </div>
      <ul class="file-upload__list">
        <li class="file-upload__item">
          <svg class="file-upload__icon">…</svg>
          <div class="file-upload__meta">
            <span class="file-upload__name">informe.pdf</span>
            <span class="file-upload__size">2.4 MB · Subiendo 45%</span>
            <div class="progress"><div class="progress__bar" style="width:45%"></div></div>
          </div>
          <button class="file-upload__remove" aria-label="Cancelar informe.pdf">×</button>
        </li>
        <li class="file-upload__item file-upload__item--error">
          <svg class="file-upload__icon">…alerta…</svg>
          <div class="file-upload__meta">
            <span class="file-upload__name">video.mov</span>
            <span class="file-upload__size">…alerta… Formato no admitido</span>
          </div>
          <button class="file-upload__remove" aria-label="Quitar video.mov">×</button>
        </li>
      </ul>

      Stepper / Wizard

      <ol> · aria-current="step" en el paso actual · el completo muestra un check (no solo color), el próximo muestra su número · estados --complete/--current/--upcoming · .step__connector entre pasos · variante --vertical.

      1. Cuenta
      2. Perfil
      3. 3 Facturación
      4. 4 Confirmar
      1. Borrador guardado
      2. 2 Revisión del equipo
      3. 3 Publicación
      Ver código
      <ol class="stepper" aria-label="Progreso de configuración">
        <li class="step step--complete">
          <span class="step__connector" aria-hidden="true"></span>
          <span class="step__marker">…check…</span>
          <span class="step__label">Cuenta</span>
        </li>
        <li class="step step--current" aria-current="step">
          <span class="step__connector" aria-hidden="true"></span>
          <span class="step__marker">3</span>
          <span class="step__label">Facturación</span>
        </li>
        <li class="step step--upcoming">
          <span class="step__marker">4</span>
          <span class="step__label">Confirmar</span>
        </li>
      </ol>
      
      <!-- Vertical: añade la clase --vertical al <ol> -->
      <ol class="stepper stepper--vertical">…</ol>

      Kbd

      Tecla en <kbd> con borde, sombra sutil de tinta y tipografía mono · tamaño pequeño, mínimo 20px · combos con "+" entre teclas.

      Esc Tab + K Ctrl + S + + P

      Inline en el texto: abre la paleta con K y guarda con Ctrl S.

      Ver código
      <kbd class="kbd">Esc</kbd>
      
      <!-- Combo: "+" literal entre teclas -->
      <span class="kbd-combo">
        <kbd class="kbd">⌘</kbd> + <kbd class="kbd">K</kbd>
      </span>

      Sistema

      Motion

      Solo transform y opacity. La salida siempre ~20 % más corta que la entrada. Distancias de 4–8 px: nada "vuela" por la pantalla.

      TokenValorUso
      --duration-instant100msPress, toggle
      --duration-fast150msHover, focus, color
      --duration-base200msDropdowns, tooltips, switches
      --duration-slow250msModales, toasts
      --duration-page320msTransiciones de página

      Easings (pasa el cursor)

      --ease-out · entradas --ease-in · salidas --ease-in-out · moverse de A a B --ease-spring · toggles y checks

      Sistema

      Accesibilidad

      WCAG AA mínimo: 4.5:1 texto normal, 3:1 texto grande y componentes UI. Touch targets de 44×44 px. Estado nunca comunicado solo con color.

      CombinaciónContrasteVeredicto
      neutral-800 sobre blanco12.42:1AAA
      Blanco sobre primary-5003.22:1Solo texto ≥18px o UI
      --link (primary-700) sobre blanco5.94:1AA texto normal
      primary-300 sobre blanco1.91:1Nunca como texto
      Tonos --*-text sobre *-1004.72–6.60:1AA garantizado

      Sistema

      Tokens y descarga

      El sistema completo vive en dist/celeste-clasica/: celeste-clasica.css (framework completo), tokens.css (solo variables), tailwind.css (@theme para Tailwind v4) y tokens.json (W3C DTCG 2025.10, interoperable con Figma / Tokens Studio / Style Dictionary).

      Variables CSS

      :root {
        /* Primario */
        --primary-50: #f2f6fa; --primary-100: #dfe9f2; --primary-200: #c3d5e6;
        --primary-300: #a0c0d4; --primary-400: #87a8c7; --primary-500: #7192ba;
        --primary-600: #5d7ba3; --primary-700: #4d6588; --primary-800: #40536e;
        --primary-900: #31343e;
      
        /* Neutrales */
        --neutral-0: #ffffff; --neutral-50: #f7f8fa; --neutral-100: #eef0f3;
        --neutral-200: #dcdfe5; --neutral-300: #b8bdc7; --neutral-400: #8a8f9c;
        --neutral-500: #666b78; --neutral-600: #4d5160; --neutral-700: #3d414e;
        --neutral-800: #31343e; --neutral-900: #22242b;
      
        /* Semánticos (ramp de 3) */
        --success-500: #3d9970; --success-100: #e2f3ec; --success-text: #2b6e50;
        --warning-500: #c9922e; --warning-100: #faf1de; --warning-text: #8a651c;
        --danger-500: #c04d4d;  --danger-100: #f9e7e7;  --danger-text: #8f3232;
        --info-500: #7192ba;    --info-100: #dfe9f2;    --info-text: #4d6588;
      
        /* Aliases (los componentes consumen SOLO esto) */
        --bg: var(--neutral-50); --surface: var(--neutral-0); --surface-alt: var(--neutral-100);
        --border: var(--neutral-200); --border-strong: var(--neutral-300);
        --text-primary: var(--neutral-800); --text-secondary: var(--neutral-600);
        --text-muted: var(--neutral-500); --text-disabled: var(--neutral-400);
        --text-on-primary: #ffffff; --text-on-primary-solid: var(--primary-700);
        --accent: var(--primary-500); --accent-hover: var(--primary-600);
        --accent-active: var(--primary-700); --accent-soft: var(--primary-50);
        --accent-soft-strong: var(--primary-100); --link: var(--primary-700);
      
        /* Tipografía */
        --font-display: "Fraunces", Georgia, serif;
        --font-body: "Public Sans", system-ui, -apple-system, sans-serif;
        --font-mono: "IBM Plex Mono", ui-monospace, monospace;
        --text-xs: .75rem; --text-sm: .875rem; --text-base: 1rem; --text-lg: 1.125rem;
        --text-xl: 1.25rem; --text-2xl: 1.5625rem; --text-3xl: 1.9375rem;
        --text-4xl: 2.4375rem; --text-5xl: 3.0625rem;
        --tracking-display: -0.02em; --tracking-label: 0.04em; --measure: 65ch;
      
        /* Espaciado (base 4px) */
        --space-1: 4px; --space-2: 8px; --space-3: 12px; --space-4: 16px;
        --space-5: 20px; --space-6: 24px; --space-8: 32px; --space-10: 40px;
        --space-12: 48px; --space-16: 64px; --space-20: 80px; --space-24: 96px;
        --control-height-sm: 36px; --control-height-md: 44px; --control-height-lg: 52px;
      
        /* Radios y sombras */
        --radius-sm: 6px; --radius-md: 10px; --radius-lg: 14px;
        --radius-xl: 20px; --radius-full: 9999px;
        --shadow-xs: 0 1px 2px rgba(49,52,62,.06);
        --shadow-sm: 0 1px 3px rgba(49,52,62,.08), 0 1px 2px rgba(49,52,62,.05);
        --shadow-md: 0 4px 8px rgba(49,52,62,.09), 0 2px 4px rgba(49,52,62,.05);
        --shadow-lg: 0 12px 24px rgba(49,52,62,.12), 0 4px 8px rgba(49,52,62,.06);
        --shadow-xl: 0 24px 48px rgba(49,52,62,.16);
        --ring: 0 0 0 3px rgba(113,146,186,.25);
      
        /* Motion */
        --duration-instant: 100ms; --duration-fast: 150ms; --duration-base: 200ms;
        --duration-slow: 250ms; --duration-page: 320ms;
        --ease-out: cubic-bezier(0.2, 0, 0, 1);
        --ease-in: cubic-bezier(0.4, 0, 1, 1);
        --ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);
        --ease-spring: cubic-bezier(0.34, 1.4, 0.64, 1);
      }

      Tailwind CSS v4 — bloque @theme

      @import "tailwindcss";
      
      @theme {
        /* Colores → genera bg-primary-500, text-neutral-800, border-primary-200… */
        --color-primary-50: #f2f6fa;  --color-primary-100: #dfe9f2;
        --color-primary-200: #c3d5e6; --color-primary-300: #a0c0d4;
        --color-primary-400: #87a8c7; --color-primary-500: #7192ba;
        --color-primary-600: #5d7ba3; --color-primary-700: #4d6588;
        --color-primary-800: #40536e; --color-primary-900: #31343e;
      
        --color-neutral-50: #f7f8fa;  --color-neutral-100: #eef0f3;
        --color-neutral-200: #dcdfe5; --color-neutral-300: #b8bdc7;
        --color-neutral-400: #8a8f9c; --color-neutral-500: #666b78;
        --color-neutral-600: #4d5160; --color-neutral-700: #3d414e;
        --color-neutral-800: #31343e; --color-neutral-900: #22242b;
      
        --color-success: #3d9970; --color-success-soft: #e2f3ec; --color-success-strong: #2b6e50;
        --color-warning: #c9922e; --color-warning-soft: #faf1de; --color-warning-strong: #8a651c;
        --color-danger: #c04d4d;  --color-danger-soft: #f9e7e7;  --color-danger-strong: #8f3232;
        --color-info: #7192ba;    --color-info-soft: #dfe9f2;    --color-info-strong: #4d6588;
      
        /* Tipografía → font-display, font-body, font-mono */
        --font-display: "Fraunces", Georgia, serif;
        --font-body: "Public Sans", system-ui, sans-serif;
        --font-mono: "IBM Plex Mono", ui-monospace, monospace;
      
        /* Radios → rounded-sm/md/lg/xl */
        --radius-sm: 6px; --radius-md: 10px; --radius-lg: 14px; --radius-xl: 20px;
      
        /* Sombras → shadow-xs…shadow-xl (teñidas de tinta) */
        --shadow-xs: 0 1px 2px rgba(49,52,62,.06);
        --shadow-sm: 0 1px 3px rgba(49,52,62,.08), 0 1px 2px rgba(49,52,62,.05);
        --shadow-md: 0 4px 8px rgba(49,52,62,.09), 0 2px 4px rgba(49,52,62,.05);
        --shadow-lg: 0 12px 24px rgba(49,52,62,.12), 0 4px 8px rgba(49,52,62,.06);
        --shadow-xl: 0 24px 48px rgba(49,52,62,.16);
      
        /* Easings → ease-out-cc, ease-in-cc, ease-in-out-cc, ease-spring */
        --ease-out-cc: cubic-bezier(0.2, 0, 0, 1);
        --ease-in-cc: cubic-bezier(0.4, 0, 1, 1);
        --ease-in-out-cc: cubic-bezier(0.65, 0, 0.35, 1);
        --ease-spring: cubic-bezier(0.34, 1.4, 0.64, 1);
      }

      Cómo consumirlo en un proyecto nuevo

      1) Instala @higinio/design-css (e importa @higinio/design-css/celeste/framework.css) o copia dist/celeste-clasica/celeste-clasica.css (o solo tokens.css) e impórtalo antes de tus estilos, o pega el bloque @theme en tu CSS de Tailwind v4. 2) Aplica .celeste-reset al body. 3) Consume solo aliases semánticos. 4) Alterna data-theme en <html> para light/dark.

      Sistema

      Instalación

      El sistema se distribuye como paquete npm (@higinio/design-css) y también como archivos sueltos en dist/celeste-clasica/. Instálalo o cópialos, y elige qué importar según tu stack (A/B/C). En todas: light por defecto; <html data-theme="dark"> activa el modo oscuro, y los componentes consumen solo aliases semánticos, nunca hex.

      Instalar desde npm (recomendado)

      Un solo paquete con los dos sistemas en subrutas /celeste/ y /nocturna/. Instálalo y usa las vías A/B/C apuntando a la subruta, en vez de a un archivo copiado.

      npm i @higinio/design-css
      
      /* framework completo (vía A) */
      @import "@higinio/design-css/celeste/framework.css";
      /* o solo tokens (vía B) */
      @import "@higinio/design-css/celeste/tokens.css";
      /* o Tailwind v4 (vía C) */
      @import "@higinio/design-css/celeste/tailwind.css";

      A · CSS drop-in (framework completo)

      Para cualquier proyecto — HTML plano o cualquier framework. Trae variables + clases de componentes listas (tipo Bootstrap) y ya importa las fuentes. Aplica .celeste-reset al <body>.

      <link rel="stylesheet" href="/estilos/celeste-clasica.css">
      
      <body class="celeste-reset">
        <button class="btn btn--primary">Guardar</button>
        <div class="card">…</div>
      </body>

      B · Solo tokens

      Si diseñas tus propios componentes: solo las variables, sin clases.

      @import "./tokens.css";
      
      .mi-panel {
        background: var(--surface);
        color: var(--text-primary);
        border: 1px solid var(--border);
      }

      C · Tailwind v4

      Tailwind v4 se configura por CSS. El tailwind.css ya incluye @import "tailwindcss", los tokens y el bloque @theme — úsalo como tu hoja de entrada (mantén tokens.css a su lado, que es lo que importa).

      # 1) instala Tailwind v4
      npm i tailwindcss @tailwindcss/postcss
      
      # 2) copia tailwind.css + tokens.css a tu carpeta de CSS
      #    y usa tailwind.css como entrada. Ya tienes utilidades:
      <div class="bg-primary-500 text-neutral-0">…</div>

      D · Pipelines de tokens

      Para Figma, Tokens Studio o Style Dictionary: importa tokens.json (formato estándar W3C DTCG 2025.10).

      Con Claude no copias nada

      Invoca la skill celeste-clasica-design o conecta el MCP (sección siguiente) y construye consumiendo tokens, componentes y reglas del sistema, con validación automática.

      Sistema

      MCP

      El paquete @higinio/design-mcp expone ambos sistemas de diseño — Celeste Clásica y Nocturna Eléctrica — a cualquier IDE o cliente compatible con Model Context Protocol: tokens, componentes, reglas duras y validación de código. Complementa a las skills de Claude, no las reemplaza: misma fuente de verdad, accesible también fuera del entorno de Claude.

      Las 8 tools

      ToolQué hace
      list_design_systemsLista los sistemas de diseño disponibles.
      get_tokenDevuelve el valor resuelto de un token o alias de un sistema.
      search_tokensBusca tokens por nombre, categoría o valor.
      list_componentsLista los componentes documentados de un sistema.
      get_component_specDevuelve la especificación completa de un componente: estados, medidas, variantes.
      get_rulesDevuelve las reglas duras (no negociables) del sistema.
      validate_codeAudita CSS/HTML contra las reglas del sistema — hex directos, contraste, aliases.
      generate_snippetGenera un snippet de componente listo para usar, con los aliases correctos.

      Conectar (remoto)

      Añade el servidor a tu .mcp.json:

      {
        "mcpServers": {
          "design": {
            "type": "http",
            "url": "https://design-mcp.higiniolab.tech/mcp",
            "headers": { "Authorization": "Bearer <tu-token>" }
          }
        }
      }

      Ejemplo

      Consultar un token de este sistema:

      get_token(system="celeste", name="--accent")
      → "#7192ba"

      Auditar código antes de integrarlo:

      validate_code(system="celeste", code="…")
      → { ok: false, issues: ["hex directo #7192ba en línea 12 — usa var(--accent)"] }

      MCP y skills, misma fuente de verdad

      Usa las skills dentro de Claude; el MCP para IDEs y clientes MCP externos. Ambos leen DESIGN-celeste-clasica.md.