Registro de HyperFrames
El registro proporciona bloques y componentes reutilizables que se pueden instalar mediante hyperframes add <name>.
- Bloques — subcomposiciones independientes (con sus propias dimensiones, duración y línea de tiempo). Se incluyen mediante
data-composition-srcen una composición anfitriona. - Componentes — fragmentos de efectos (sin dimensiones propias). Se pegan directamente en el HTML de la composición anfitriona.
Cuándo usar esta habilidad
- El usuario menciona
hyperframes add, "bloque", "componente" ohyperframes.json. - Aparece la salida de
hyperframes adden la sesión (rutas de archivo, fragmento en el portapapeles). - Necesitas conectar un elemento instalado en una composición existente.
- Deseas descubrir qué hay disponible en el registro.
Referencia rápida
hyperframes add data-chart # instala un bloque
hyperframes add grain-overlay # instala un componente
hyperframes add shimmer-sweep --dir . # apunta a un proyecto específico
hyperframes add data-chart --json # salida legible por máquina
hyperframes add data-chart --no-clipboard # omite el portapapeles (CI/headless)
Después de la instalación, la CLI imprime qué archivos se escribieron y un fragmento para pegar en tu composición anfitriona. El fragmento es un punto de partida: deberás agregar los atributos data-composition-id (debe coincidir con el ID de composición interno del bloque), data-start y data-track-index al conectar bloques.
Nota: hyperframes add solo funciona para bloques y componentes. Para ejemplos, usa hyperframes init <dir> --example <name> en su lugar.
Ubicaciones de instalación
Los bloques se instalan en compositions/<name>.html por defecto.
Los componentes se instalan en compositions/components/<name>.html por defecto.
Estas rutas son configurables en hyperframes.json:
{
"registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
"paths": {
"blocks": "compositions",
"components": "compositions/components",
"assets": "assets"
}
}
Consulta install-locations.md para obtener todos los detalles.
Conexión de bloques
Los bloques son composiciones independientes: inclúyelos mediante data-composition-src en tu index.html anfitrión:
<div
data-composition-id="data-chart"
data-composition-src="compositions/data-chart.html"
data-start="2"
data-duration="15"
data-track-index="1"
data-width="1920"
data-height="1080"
></div>
Atributos clave:
data-composition-src— ruta al archivo HTML del bloquedata-composition-id— debe coincidir con el ID interno del bloquedata-start— cuándo aparece el bloque en la línea de tiempo anfitriona (segundos)data-duration— durante cuánto tiempo se reproduce el bloquedata-width/data-height— dimensiones del lienzo del bloquedata-track-index— orden de capas (superior = al frente)
Consulta wiring-blocks.md para obtener todos los detalles.
Conexión de componentes
Los componentes son fragmentos: pega su HTML en el marcado de tu composición, su CSS en tu bloque de estilos y su JS en tu script (si lo hay):
- Lee el archivo instalado (por ejemplo,
compositions/components/grain-overlay.html). - Copia los elementos HTML dentro de tu
<div data-composition-id="...">. - Copia el bloque
<style>en los estilos de tu composición. - Copia cualquier contenido
<script>en el script de tu composición (antes del código de la línea de tiempo). - Si el componente expone integración con la línea de tiempo de GSAP (consulta el bloque de comentarios en el fragmento), agrega esas llamadas a tu línea de tiempo.
Consulta wiring-components.md para obtener todos los detalles.
Descubrimiento
Navega por los elementos disponibles:
# Lee el manifiesto del registro
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json
El registry-item.json de cada elemento contiene: nombre, tipo, título, descripción, etiquetas, dimensiones (solo bloques), duración (solo bloques) y lista de archivos.
Consulta discovery.md para obtener detalles sobre cómo filtrar por tipo y etiquetas.