wissive.

Emojis interactivos con expresiones vivas, sonidos y personalización única con personalidad propia — añade micro vida a tu web.

Probalo — hacé click o pasá el mouse

Tu propio emoji

Base círculo, rasgos a elección: ojos, boca, personalidad, partículas y sonido de cualquiera de los 14, mezclados como quieras.

Color:
Forma:
Ojos de:
Boca de:
Personalidad de:
Partículas de:
Sonido de:
Tamaño:
Banco de animaciones — qué visita solo en reposo:

Tu configuración, lista para copiar:

Studio de Animación

Compón tus propias animaciones a partir de los diseños, expresiones y estados. Arrastra el cabezal para previsualizar en tiempo real y exporta el montaje.

Frame 1: 1: Verde Normal
Secuencia: 5 Frames
0:000:05
0s
1s
2s
3s
4s
5s
1: Verde Normal
1,0 s
2: Negro & Sonrisa
1,0 s
3: Mira a la Izquierda
1,2 s
4: Amarillo & Sorpresa
1,0 s
5: Llama & Salto
1,5 s
102 %
0:00 / 0:05

Introducción

Wissive es una librería de JavaScript/TypeScript vanilla — sin framework ni dependencias de runtime obligatorias — que renderiza 14 personajes tipo blob con diseño propio e interactividad en tiempo real. Cada uno cuenta con 24 expresiones repartidas en 4 estados de interacción, interpoladas mediante un resorte amortiguado (spring physics) en lugar de una transition lineal de CSS, logrando un movimiento orgánico y vivo.

No es solo un set de iconos: es un motor de expresión completo. Además de su catálogo prediseñado, te permite crear y personalizar tu propio emoji combinando siluetas, ojos, bocas, colores, sonidos y partículas a tu medida con solo unas líneas de código.

Instalación

Vía pnpm, para usar con un bundler:

pnpm add wissive
import { createEmoji } from 'wissive';

createEmoji('mochi', { target: document.querySelector('#slot') });

O vía CDN, sin instalar nada:

<script src="https://cdn.jsdelivr.net/npm/wissive/dist/wissive.umd.js"></script>
<div id="slot"></div>
<script>
  Wissive.createEmoji('mochi', { target: document.querySelector('#slot') });
</script>

Micro-librería ligera sin dependencias de runtime obligatorias.

Casos de uso

No es solo un catálogo para mirar: cada personaje está pensado para vivir dentro de una interfaz real. Estos son mockups de UI armados con CSS — el emoji de cada uno es una instancia real, montada con createEmoji().

Ícono de botón
Logo / marca
nimbly. Inicio · Precios · Blog
Estado vacío

No hay resultados todavía

Notificación
Listo Tus cambios se guardaron.
Asistente / chat
¡Hola! ¿en qué te ayudo hoy?
Estado de carga
Feedback de formulario
Mascota flotante
Avatar de usuario
Caro hace 2h

¡Se ve buenísimo, felicitaciones!

Uso básico

Tres formas comunes de usar createEmoji(), con el código real de cada una.

Emoji básico
Control programático
Solo decorativo (sin listeners)

Opciones

Segundo parámetro de createEmoji(name, options).

OpciónTipoDefaultQué hace
targetHTMLElement—Dónde se monta (requerido).
sizepreset | number'base'Tamaño en px, o xs/sm/base/lg/xl/2xl.
interactivebooleantruefalse = solo decorativo, sin listeners.
soundbooleantrueRequiere Cuelume instalada.
draggablebooleantrueArrastrable, con física de resorte.
nearRadiusnumber120Radio en px para el estado near.
gazeTrackingbooleanfalseLos ojos siguen el cursor.
ambientParticlesbooleantruePartículas ocasionales en reposo.
autonomousStatesbooleantrueVisita reacciones al azar en reposo.
reducedMotion'auto' | boolean'auto'Sigue prefers-reduced-motion, o se fuerza.
theme'auto' | ThemeOption'auto'Color base personalizado.

Estados de interacción

Cada estado dispara un pool de variantes; se sortea una evitando repetir la anterior.

EstadoDisparadorDescripción
idleSin interacciónReposo, respiración lenta.
nearCursor se acerca (radio configurable)El emoji "nota" que algo se acerca.
hovermouseenter / mouseleaveCursor directamente encima.
clickmousedown/up, touchstart, Enter/EspacioInteracción directa.
emoji.setEmotion('hover'); // control programático, sin mouse
emoji.destroy();           // limpieza: RAF + listeners + timers

Sonido (opcional)

Integración opcional con Cuelume — peer dependency, nunca obligatoria. Se detecta en tiempo de ejecución (import dinámico); si no está instalada, la librería funciona igual, en silencio, sin errores en consola.

import { createEmoji, setGlobalSound, setGlobalVolume } from 'wissive';

// Por instancia
const emoji = createEmoji('mochi', { target, sound: true });
emoji.setSound(false); // silenciar solo esta instancia

// Control global para toda la aplicación
setGlobalSound(false);   // silencia todos los emojis a la vez
setGlobalVolume(0.5);    // ajusta el volumen global (0.0 a 1.0)

Accesibilidad

role="img" + aria-label dinámico según la emoción y el estado actual. Navegable por teclado (tabindex, Enter/Espacio equivalen a click). Respeta prefers-reduced-motion del sistema operativo. Contraste trazo/relleno verificado ≥3:1 (WCAG) en los 14 emojis.

Móvil y Pantallas Táctiles

En dispositivos móviles no existe el cursor continuo ni el estado :hover. Wissive detecta automáticamente el entorno táctil (isTouchDevice() / supportsHover()) y optimiza el comportamiento:

  • Ahorro de batería y CPU: Desactiva los cálculos continuos de proximidad de ratón en pantallas puramente táctiles.
  • Gestión de toques limpia: Los eventos touchstart y touchend activan y restauran las expresiones al instante, evitando estados "hover" pegados.
  • Física de arrastre táctil: DragPhysics soporta gestos táctiles directos con inercia y rebote sin interferir con el scroll del navegador.
  • Micro-vida autónoma: Con autonomousStates: true, los emojis parpadean, exploran miradas y cambian de emoción por sí mismos sin requerir interacción del usuario.
import { createEmoji, isTouchDevice, supportsHover } from 'wissive';

// Detectar entorno si necesitas lógica condicional
console.log('¿Dispositivo táctil?:', isTouchDevice());

// Instancia optimizada para móvil y escritorio
const emoji = createEmoji('mochi', {
  target: document.getElementById('emoji-slot'),
  draggable: true,         // arrastrable con el dedo o ratón
  autonomousStates: true,  // expresa micro-vida sin necesidad de hover
  sound: true,             // feedback sonoro al tocar
});

Integración con frameworks

Wrappers oficiales para React, Vue y Astro (wissive/react, wissive/vue, wissive/astro) — para React/Vue encapsulan el patrón createEmoji() + destroy() de siempre; en Astro no hay problema de timing que resolver (no hace falta), solo ahorran repetir el <script> si usás el emoji en varias páginas. Elegí uno — el bloque de abajo lo recuerda.

Ejemplos completos en examples/.

Rendimiento & Estrés (Fase 9)

Wissive utiliza un único bucle central requestAnimationFrame compartido y cálculos de física sub-stepped ultra-optimizados. Pon a prueba la librería renderizando 50 o 100 emojis vivos simultáneos con física de resorte y partículas en tiempo real.

Instancias: 0
Rendimiento: 60 FPS

Resultados del Benchmark Automatizado

  • 50 instancias activas: ~1.81 ms por frame (~550 FPS teórico, 11% del frame budget de 16.6ms).
  • 100 instancias activas: ~3.62 ms por frame (~275 FPS teórico, 21% del frame budget).
  • 200 instancias activas: ~5.12 ms por frame (~195 FPS teórico, holgadamente a 60 FPS estables).
  • Memoria: 0 fugas de memoria gracias a la limpieza determinística de .destroy().

Créditos

MIT license. Sonido opcional vía Cuelume.