Catálogo — 14 personalidades
Cada emoji tiene 24 expresiones repartidas en 4 estados. Probá los controles, o
clickeá el nombre de cualquier emoji para copiar su createEmoji().
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.
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.
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().
No hay resultados todavía
Uso básico
Tres formas comunes de usar createEmoji(), con el código real de cada una.
createEmoji('mochi', { target, size: 100 }); const emoji = createEmoji('mochi', { target });
emoji.setEmotion('happy');
emoji.setEmotion('sad');
emoji.bounce(); // No reacciona a hover/click/near; solo su animación de personalidad
createEmoji('nima', { target, interactive: false }); Opciones
Segundo parámetro de createEmoji(name, options).
| Opción | Tipo | Default | Qué hace |
|---|---|---|---|
target | HTMLElement | — | Dónde se monta (requerido). |
size | preset | number | 'base' | Tamaño en px, o xs/sm/base/lg/xl/2xl. |
interactive | boolean | true | false = solo decorativo, sin listeners. |
sound | boolean | true | Requiere Cuelume instalada. |
draggable | boolean | true | Arrastrable, con física de resorte. |
nearRadius | number | 120 | Radio en px para el estado near. |
gazeTracking | boolean | false | Los ojos siguen el cursor. |
ambientParticles | boolean | true | Partículas ocasionales en reposo. |
autonomousStates | boolean | true | Visita 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.
| Estado | Disparador | Descripción |
|---|---|---|
idle | Sin interacción | Reposo, respiración lenta. |
near | Cursor se acerca (radio configurable) | El emoji "nota" que algo se acerca. |
hover | mouseenter / mouseleave | Cursor directamente encima. |
click | mousedown/up, touchstart, Enter/Espacio | Interacció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
touchstartytouchendactivan y restauran las expresiones al instante, evitando estados "hover" pegados. - Física de arrastre táctil:
DragPhysicssoporta 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.
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.
¡Se ve buenísimo, felicitaciones!