Communitygithub.com

Anime.js para HyperFrames

Patrones de adaptador de Anime.js para HyperFrames. Útil al escribir animaciones o líneas de tiempo de Anime.js dentro de composiciones de HyperFrames, registrar animaciones en window.__hfAnime, hacer que Anime.js sea controlado por seek y determinista, o traducir ejemplos de Anime.js a HTML renderizable de HyperFrames.

¿Qué es Anime.js para HyperFrames?

Esta skill define un contrato y patrones claros para integrar la biblioteca de animación Anime.js dentro del ecosistema de HyperFrames. HyperFrames controla el reloj de la animación, y las instancias de Anime.js deben avanzar mecánicamente a través del tiempo proporcionado por HyperFrames, en lugar de usar su propio reloj interno. El usuario debe crear animaciones o líneas de tiempo de forma síncrona durante la inicialización, establecer `autoplay: false`, y registrar cada instancia devuelta en el array global `window.__hfAnime`. El adaptador luego busca (`seek()`) cada instancia registrada con el tiempo de HyperFrames en milisegundos, lo que garantiza animaciones deterministas y buscables. La skill soporta construcciones de Anime.js tanto en modo IIFE clásico como en módulo ES, y proporciona patrones básicos y de línea de tiempo, incluyendo un ejemplo de módulo. Se recomienda usar Anime.js para pequeñas florituras SVG y DOM donde su sintaxis sea compacta, o para importar ejemplos existentes de Anime.js y hacerlos buscables, mientras que para secuencias complejas se prefiere GSAP.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shengdabai/Tony-Claude-Code-Skills/tree/HEAD/skills/hyperframes-animejs

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Anime.js para HyperFrames?

HyperFrames puede buscar instancias de Anime.js a través de su adaptador de tiempo de ejecución animejs. La composición posee los objetos de animación; HyperFrames posee el reloj.

Contrato

  • Crea animaciones o líneas de tiempo de forma síncrona durante la inicialización de la composición.
  • Establece autoplay: false para que Anime.js no avance por su propio reloj.
  • Registra cada animación o línea de tiempo devuelta en window.__hfAnime.
  • Usa duraciones finitas y recuentos de bucle finitos.
  • Evita callbacks que muten el DOM basados en la hora del reloj de pared, el estado de la red o aleatoriedad sin semilla.

El adaptador busca cada instancia registrada con instance.seek(timeMs), donde timeMs es el tiempo de HyperFrames en milisegundos.

Patrón Básico

<script src="https://cdn.jsdelivr.net/npm/[email protected]/lib/anime.iife.min.js"></script>
<script>
  const anim = anime({
    targets: ".mark",
    translateX: 280,
    rotate: "1turn",
    opacity: [0, 1],
    duration: 1200,
    easing: "easeOutExpo",
    autoplay: false,
  });

  window.__hfAnime = window.__hfAnime || [];
  window.__hfAnime.push(anim);
</script>

Patrón de Línea de Tiempo

<script>
  const tl = anime.timeline({
    autoplay: false,
    easing: "easeOutCubic",
  });

  tl.add({
    targets: ".title",
    translateY: [40, 0],
    opacity: [0, 1],
    duration: 650,
  }).add(
    {
      targets: ".accent",
      scaleX: [0, 1],
      duration: 450,
    },
    250,
  );

  window.__hfAnime = window.__hfAnime || [];
  window.__hfAnime.push(tl);
</script>

Construcciones con Módulos

Si usas una construcción de módulo ES, al adaptador no le importa cómo se creó la instancia. Solo necesita que el objeto devuelto exponga seek(), pause(), y preferiblemente play():

<script type="module">
  import { animate } from "https://cdn.jsdelivr.net/npm/animejs/+esm";

  const anim = animate(".chip", {
    x: "18rem",
    duration: 900,
    autoplay: false,
  });

  window.__hfAnime = window.__hfAnime || [];
  window.__hfAnime.push(anim);
</script>

Buenos Usos

  • Pequeñas florituras SVG y DOM donde la sintaxis de Anime.js es compacta.
  • Ejemplos importados de Anime.js que pueden hacerse buscables.
  • Múltiples micro-animaciones independientes insertadas en el mismo registro.

Usa GSAP para secuencias de escenas complejas a menos que el usuario solicite específicamente Anime.js. GSAP sigue siendo la ruta principal de creación de HyperFrames.

Evitar

  • Dejar autoplay en el valor predeterminado de Anime.js.
  • Depender del autodescubrimiento anime.running en lugar de window.__hfAnime.push(...) explícito.
  • Bucles infinitos. Calcula un recuento de repeticiones finito a partir de la duración de la composición.
  • Construir animaciones en temporizadores, promesas, manejadores de eventos o después de cargas de assets asíncronas.

Validación

Después de editar una composición que usa Anime.js:

npx hyperframes lint
npx hyperframes validate

Créditos y Referencias

  • Código fuente del adaptador de HyperFrames: packages/core/src/runtime/adapters/animejs.ts.
  • Documentación de Anime.js para autoplay, pause() y seek(): https://animejs.com/documentation/

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

shengdabai/Tony-Claude-Code-Skills

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

shengdabai/Tony-Claude-Code-Skills

接收抖音、小红书、微信视频号等短视频链接或分享文案,查询作品/账号数据并提取语音文字稿,按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用;运行前检查 TikHub 与轻抖使用凭证,缺少时用新手能理解的方式引导购买和安全配置。

shengdabai/Tony-Claude-Code-Skills

Read-only queue dashboard for workspace-aware ship. (gstack)

shengdabai/Tony-Claude-Code-Skills

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

shengdabai/Tony-Claude-Code-Skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

shengdabai/Tony-Claude-Code-Skills

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

shengdabai/Tony-Claude-Code-Skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

shengdabai/Tony-Claude-Code-Skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Skills relacionados