Producción HyperFrames
Implementa un storyboard aprobado. Si no hay storyboard, detente y ejecuta motion-storyboard.
Elegir el renderizador
| Situación | Renderizador |
|---|---|
| Por defecto para trabajo nuevo; habilidades HTML/CSS/GSAP; bloques de registro deseados | HyperFrames (npx hyperframes …) |
| El proyecto ya usa Remotion | permanecer en Remotion; se aplican las mismas reglas de determinismo |
Un repositorio de producto ya tiene su propio estudio (seek(t) + Playwright + FFmpeg) | usar ese estudio; no introducir un segundo |
| Edición pura de material existente | saltar esta habilidad → video-edit-qc |
Instalar la CLI de HyperFrames o añadir bloques de registro (npx hyperframes add …) instala código de terceros: confirma con el usuario primero y fija la versión en package.json. No ejecutes comandos de autoactualización para habilidades (npx hyperframes skills update, npx skills add …) por tu cuenta.
Contrato de composición (HyperFrames)
- Raíz independiente:
<div data-composition-id="main" data-width="1920" data-height="1080" data-duration="24">directamente en<body>, con tamañowidth/height: 100%— nunca codifiques el tamaño en píxeles en la raíz. Las subcomposiciones (cargadas mediantedata-composition-src) envuelven su raíz en<template>y mantienen su<style>/<script>dentro de él. - Una línea de tiempo en pausa por composición:
window.__timelines["<composition-id>"] = gsap.timeline({ paused: true }), registrada después de que la compilación termine (puede compilarse dentro dedocument.fonts.ready). La duración del render proviene deldata-durationde la raíz. - Clips temporizados: los elementos con
class="clip"ydata-start/data-durationse muestran y ocultan mediante el runtime. Nunca hagas tween dedisplay,visibilityoautoAlphaen un.clip; anima un hijo. - Transformaciones: nunca combines un
transformCSS inicial con un tween de GSAP en la misma propiedad; usagsap.fromTo. Centra con flex/inset, no contranslate(-50%,-50%)en un nodo que también muevas. - Medios: cada
<audio>tiene unid(de lo contrario el render sale silencioso); no pongascrossoriginen medios; no pongasdata-starten un<video>y en un ancestro. - Fuentes: cada
font-familynombrada tiene un@font-faceen el archivo que apunte a un archivo local enviado. - Determinismo: no lecturas de reloj,
Math.randomsin semilla, solicitudes de red en tiempo de render, estado de entrada o repeticiones infinitas (repeat: -1). Usa un PRNG con semilla cuando se necesite aleatoriedad. - Ids: únicos en toda la página ensamblada; antepone los ids de las subcomposiciones con el id de la composición.
Orden de construcción
npx hyperframes init(después de la confirmación) o abre el proyecto existente.- Escribe una especificación de diseño (
frame.md/design.md): tokens, escala tipográfica, cuadrícula, áreas seguras, por relación de aspecto. Primero los fotogramas en reposo — cada beat debe funcionar como un fotograma fijo. - Construye escena por escena en el orden del storyboard; implementa las costuras del mapa de transiciones (
motion-choreography), primero los portadores. - Coloca el audio desde
voice-video-sync: base musical, VO, SFX con ids y tiempos de inicio desde el archivo de línea de tiempo — nunca suposiciones escritas a mano. - Mantén el texto nítido: mueve contenedores, no glifos; no uses
will-changeen texto.
Validar
Ejecuta en este orden y corrige antes de continuar:
npx hyperframes lint # errores de contrato; un error de lint deshabilita las auditorías de layout/contraste
npx hyperframes check # layout, desbordamiento, contraste
npx hyperframes snapshot # fotogramas fijos para revisión; comparar con los beats del storyboard
npx hyperframes preview # vista previa local para el usuario
Luego renderiza localmente: npx hyperframes render --quality <draft|high>. Primero borrador (ventana ≤30 s o baja calidad) para la aprobación del usuario, luego el final.
Comandos hacia el exterior — publish, cloud, lambda, cloudrun, feedback, auth, y configuraciones de telemetría — suben datos o cambian cuentas. Ejecútalos solo cuando el usuario lo pida.
Pipeline personalizado seek(t) (cuando no se usa HyperFrames)
composition(t) → Playwright page.evaluate(seek, t) → esperar fuentes/imágenes → captura de pantalla
→ N subfotogramas por fotograma de salida → ffmpeg tmix (desenfoque de movimiento) → x264/x265 → multiplexar audio
- 60 fps × 4 subfotogramas, obturador 0.5, es un buen valor por defecto; reduce el desenfoque en fotogramas donde cambien números si perjudica la legibilidad.
- Codificación maestra (archivo y fuente de reedición):
-c:v libx264 -pix_fmt yuv420p -crf 16 -preset slow, AAC 320 kbps. Las codificaciones de entrega a plataformas se derivan de ella envideo-edit-qc. - La misma marca de tiempo renderizada dos veces debe producir píxeles idénticos; pruébalo en 3 fotogramas aleatorios.
Entrega
Entrega el render más los fotogramas fijos/hoja de contactos a video-edit-qc. Cuando las habilidades de HyperFrames estén instaladas (hyperframes-core, hyperframes-animation, hyperframes-creative, hyperframes-cli), úsalas para indicadores exactos, adaptadores (Lottie, Three.js, …) y nombres de bloques de registro.