Instalación de plugins: Antes de ejecutar comandos de configuración o actualización, sigue las reglas de ejecución de plugins cuando este skill esté dentro de un plugin de HyperFrames. Las instalaciones independientes conservan las instrucciones de actualización a continuación.
HyperFrames Keyframes
Los keyframes son un contrato de pose: estados visibles, identidad continua del sujeto, tiempo de ejecución seguro para búsqueda, píxeles verificados.
Usa hyperframes-animation para recetas de escena amplias. Usa hyperframes-cli para la documentación completa de comandos. Usa references/keyframe-patterns.md solo al elegir mecanismos de implementación, no el estilo visual.
Límite de edición para creadores
Keyframes controla el movimiento visual, no el montaje de clips. Los cortes directos por rango de origen, recortes, empalmes y reordenaciones pertenecen a /hyperframes-core: autoriza un elemento multimedia por rango conservado, colócalo con data-start y data-duration, y selecciona su desplazamiento de origen con data-media-start. Los rangos adyacentes forman un corte directo. Un fundido cruzado usa clips superpuestos en diferentes pistas más keyframes de opacidad visual; los fundidos de sonido usan /hyperframes-audio.
| Solicitud del creador | Mecanismo verdadero |
|---|---|
| Punch-in / punch-out | Keyframe scale con x/y o porcentaje de traslación en un contenedor visual/sin tiempo dentro del clip. Usa un tween fijo/corto para un golpe brusco y un tween para un movimiento suave. |
| Zoom o reencuadre suave multi-estado | Mantén vivo un contenedor de sujeto y autoriza múltiples estados de zoom/reencuadre como una escalera de poses con easing por segmento. |
| Panorámica, reencuadre o movimiento de cámara Ken Burns | Anima la traslación del contenedor más la escala. La geometría se autoriza; esto no es seguimiento facial ni reencuadre semántico automático. |
| Movimientos de cámara encadenados | Encadena pulsos de transformación etiquetados en una línea de tiempo segura para búsqueda registrada. |
| Corte coincidente o panorámica de barrido | /hyperframes-animation es dueño de la transición visual; /hyperframes-registry proporciona primitivas; los keyframes preservan la geometría, dirección y velocidad autorizadas. No hay descubrimiento automático de fotogramas coincidentes. |
| Reencuadre con recorte y máscara | Interpola clip-path o una máscara en un contenedor visual interno para recortar/reencuadrar sin cambiar el tiempo de origen. Los keyframes de polígono pueden formar una transición de polígono/máscara. |
| Corte de barrido direccional o corte iris/revelación | Anima un límite de máscara/recorte a través de clips visuales superpuestos; /hyperframes-animation es dueño de la coreografía de la transición. |
| Transición de pantalla dividida | Mantén ambos clips visuales colocados por core, luego anima sus contenedores internos de recorte/máscara y la geometría divisoria. |
| Re-temporización constante de origen | /hyperframes-core es dueño de data-playback-rate normalizado (0.1..10) para imagen segura al renderizar y sonido con tono preservado. Es constante para todo el elemento multimedia. |
| Rampas de velocidad de origen | Un carril de rate en data-automation en el <video>/<audio> (t en segundos del clip, v 0.1..10, interpolación logarítmica); prevalece sobre la tasa constante. |
| Congelar / mantener | Una pose visual, el fotograma final de origen o una subcomposición terminada puede mantenerse. No se admite la congelación arbitraria en medio del origen; preprocesa un segmento fijo/derivado, colócalo como su propio clip, luego reanuda con otro rango de origen. |
Al editar imagen y sonido juntos, carga /hyperframes-core, este skill para movimiento visual y /hyperframes-audio para fundidos, fundidos cruzados, automatización de volumen, ducking/cincelado o efectos en las pistas colocadas.
Un tratamiento visual o de recorte no es un recorte temporal de origen o empalme. /hyperframes-core es dueño de la línea de tiempo, la temporización de clips y los rangos de origen; los keyframes solo animan la transición visual o el recorte en los contenedores dentro de esos clips. Para recetas combinadas de imagen/sonido copiables, usa /hyperframes-core → references/creator-editing-recipes.md.
Procedimiento
- Identifica el sujeto animado, los estados visibles, el estado final y el tiempo de ejecución.
- Elige el mecanismo más pequeño que demuestre la solicitud. Lee
references/keyframe-patterns.mdsolo si el mecanismo no está claro. - Autoriza keyframes seguros para búsqueda en el tiempo de ejecución declarado. Registra la instancia de tiempo de ejecución solo después de que la compilación termine; está bien compilar dentro de
document.fonts.ready. - Verifica con
hyperframes check(ejecuta lint),hyperframes keyframes, un--shotenfocado y capturas instantáneas en tiempos de prueba. - Si la prueba falla, corrige los keyframes de origen y vuelve a ejecutar el diagnóstico más pequeño que falle antes de renderizar.
Contrato
- Nombra el sujeto en movimiento.
- Nombra las poses necesarias para demostrar el movimiento previsto, incluido el estado final.
- Aplica keyframes a canales visibles, no a estado auxiliar oculto.
- Preserva la identidad del objeto cuando la continuidad importa.
- Fundido cruzado solo cuando el movimiento previsto es reemplazo o disolución.
- Mantén los estados legibles o semánticos el tiempo suficiente para verlos.
- El fotograma final es parte de la animación, no de la limpieza.
- No restablezcas al reposo a menos que se solicite.
- No termines en negro a menos que se solicite.
- Si estás editando una escena inicial, preserva el diseño, la copia, los activos, los colores y el estado final a menos que se solicite rediseñar.
Reglas de tiempo de ejecución
GSAP:
- compila al cargar la página o dentro de
document.fonts.ready, y registra solo después de que la compilación termine - usa
gsap.timeline({ paused: true }) - registra como
window.__timelines[compositionId] - la clave de registro debe coincidir con
data-composition-id - no llames a
tl.play()para el movimiento crítico de renderizado - mantén las repeticiones finitas
CSS keyframes:
- duración finita y número de iteraciones
- retardo determinista
animation-fill-mode: both- usa
data-startcuando la temporización pertenezca a un clip
Anime.js:
- crea sincrónicamente
autoplay: false- duración y bucles finitos
- empuja cada instancia a
window.__hfAnime
WAAPI:
durationfinitofill: "both"- construcción determinista
- la superficie de texto no lista WAAPI; verifica con
--shot(busca WAAPI) y capturas instantáneas
Nunca uses para el movimiento crítico de renderizado:
Date.now()performance.now()Math.random()sin semilla- disparadores de hover/desplazamiento
- temporizadores
- una línea de tiempo registrada antes de que termine su compilación asíncrona
requestAnimationFrameno registrado- bucles infinitos
Esqueleto GSAP
const root = document.querySelector("[data-composition-id]");
const compositionId = root.dataset.compositionId;
const tl = gsap.timeline({ paused: true });
tl.addLabel("state-a", 0);
tl.to(".subject", {
keyframes: [
{ x: 0, opacity: 1, duration: 0.2 },
{ x: 120, opacity: 1, duration: 0.4, ease: "power2.out" },
{ x: 100, opacity: 1, duration: 0.2, ease: "power2.inOut" },
],
ease: "none",
});
window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;
Usa etiquetas para estados semánticos. Usa parámetros de posición en lugar de retrasos encadenados. Usa immediateRender: false para tweens from()/fromTo() posteriores que toquen la misma propiedad.
Formas de Keyframes
- Array keyframes: escalera de poses con duración/easing por paso.
- Porcentaje keyframes: temporización exacta dentro de un tween.
- Arrays de propiedades: cambios multi-parada compactos.
ease: "none"en el padre cuando cada parada lleva su propio easing.easeEachcuando cada segmento debe compartir la misma sensación.
No copies distancias numéricas o temporizaciones de los ejemplos. Deducelas de la geometría y duración reales de la composición.
Para un sujeto que se mueve entre dos cajas, prefiere un tween de transformación continuo o FLIP. Divide x/y/scale en múltiples keyframes con easing solo cuando el espectador deba sentir pulsos distintos; cada segmento cambia la velocidad y puede leerse como un tropiezo.
Canales
Prefiere canales de compositor/visuales: x/y/z, xPercent/yPercent, scale, rotationX/Y/Z, skew, transformOrigin, svgOrigin, opacity, autoAlpha, clip-path, máscaras, variables CSS, valores SVG path/dash, transformaciones de cámara, uniformes de shader.
Evita canales de diseño/ciclo de vida: top/left/right/bottom, width/height, margin/padding, display, visibility, creación tardía de DOM, superposiciones auxiliares que hacen el movimiento del sujeto.
Para cambios de visibilidad, usa autoAlpha en la línea de tiempo GSAP registrada y buscable, o un tl.set() de duración cero en un límite explícito. Apunta solo a un elemento que no sea de clip o un contenedor dentro del clip; nunca apuntes a .clip mismo. Nunca hagas tween de duración sobre visibility sin procesar, y nunca hagas tween de display.
Elección de Mecanismo
Elige el mecanismo más pequeño que demuestre la solicitud:
| Necesidad | Mecanismo |
|---|---|
| Mismo sujeto cambia de caja o jerarquía | elemento compartido / FLIP |
| Sujeto recorre una ruta visible | recorrido de ruta |
| Trazo crece o traza | dibujo de trazo |
| Forma se convierte en otra forma | interpolación de forma |
| Límite de revelación es visible | clip, máscara o uniforme de shader |
| Muchos elementos se mueven con orden | escalonamiento / retraso indexado |
| El texto mismo se mueve | subdivisión de línea, palabra, carácter o banda |
| Superficie se dobla, estira o recorta | contratransformación padre/hijo |
| UI tiene estados | máquina de estados explícita |
| Escena tiene profundidad | DOM 3D, Three.js o WebGL cámara/objeto keyframes |
Los mecanismos pueden combinarse, pero cada uno debe aclarar la idea. La decoración no es una prueba.
Sincronización
- Anticipación solo cuando aclara la causa o la dirección.
- La aceleración sale del reposo.
- La prueba máxima muestra el mecanismo de manera inequívoca.
- El seguimiento vende energía y dirección.
- Sobreimpulso solo cuando el sujeto debe sentirse elástico o táctil.
- El recorrido de ruta a velocidad constante generalmente necesita
ease: "none". - Los estados discretos de UI generalmente necesitan un sharp ease-out.
- Los elementos repetidos necesitan desplazamientos ordenados, no sincronización idéntica.
- Los bloqueos finales necesitan mantenciones más largas que las poses de transición.
- Suavidad significa velocidad continua en el mismo sujeto.
- No superpongas tweens que escriban la misma propiedad de transformación a menos que la superposición sea intencional y verificada.
- Evita animar grandes cambios de
clip-path/máscara mientras la misma superficie principal también se escala o viaja; usa revelaciones anidadas después de que el movimiento principal se asiente.
Texto
Preserva los cuadros de línea, el espaciado de palabras, la legibilidad y el ajuste final. Si el texto se mueve internamente, mueve los glifos o las bandas enmascaradas, no solo las decoraciones alrededor del texto. Captura instantánea de fotogramas legibles.
SVG
Para el crecimiento de trazo, prefiere DrawSVGPlugin, luego stroke-dasharray/stroke-dashoffset. Para la interpolación de formas, prefiere MorphSVGPlugin; convierte primitivas en rutas cuando sea necesario y divide siluetas complejas en partes más simples.
3D
La escala sola es profundidad falsa. Usa perspectiva en un padre estable, transform-style: preserve-3d, viaje en z, rotación, movimiento de cámara/mundo, oclusión y orden de capas cuando los objetos se crucen.
Usa uno o dos ángulos de diagnóstico que expongan la relación de profundidad. Si la prueba en ángulo no muestra cruce de profundidad, mejora la z/cámara/oclusión.
Canvas / WebGL
Aplica keyframes a la posición de la cámara, objetivo de la cámara, transformación del objeto, opacidad del material, uniformes del shader e intensidad del postprocesado a través del estado determinista. Renderiza desde el tiempo de HyperFrames. Usa --ghost porque los cuadros de marcador no pueden ver el movimiento interno del canvas.
Prueba CLI
npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<file>" --ghost --angle <angle>
npx hyperframes snapshot . --at <times>
Elige <selector> para el sujeto animado real. Elige <times> para el primer fotograma, poses de prueba, final-menos-mantención y final exacto. Elige <angle> solo cuando la profundidad deba demostrarse.
| Herramienta | Demuestra |
|---|---|
keyframes | objetivos, paradas explícitas, rutas, trazas, movimiento padre/hijo compuesto, paradas CSS, registro Anime |
--shot | fantasmas, forma de ruta, espaciado de tiempo, proyección DOM 3D, prueba de selector enfocada |
--layout strip | movimiento in situ, superposiciones, contacto, escala/opacidad sutiles, ondas de texto |
--ghost | canvas, WebGL, movimiento de shader, 3D renderizado |
snapshot --at | máscaras, pendiente de actualización… |