Referencia de creación de HyperFrames para este puente
Esta referencia concisa está redactada para el harness. La guía completa del producto se encuentra en la aplicación de escritorio instalada y en la documentación oficial de HyperFrames.
Composición
Un archivo index.html independiente tiene una raíz de composición directamente en el body. Usa data-composition-id, data-width, data-height y un data-duration finito. El CSS width/height de la raíz son 100%; las dimensiones del canvas pertenecen a sus atributos data. Una subcomposición usa una plantilla con sus estilos/scripts en su interior.
Asigna a los clips la clase clip, con data-start/data-duration intencionados y data-track-index. Una pista es un carril de Studio, no una restricción de tiempo ni un z-index. La duración raíz debe incluir el final de todos los clips previstos. Conserva la temporización, los identificadores y los medios no relacionados al editar.
Registra una línea de tiempo de GSAP pausada en window.__timelines[compositionId], usando el mismo ID que la raíz. Anima los elementos internos; el framework controla la visibilidad del clip y la búsqueda de medios. No animes clip display, visibility o autoAlpha. Evita conflictos entre CSS-transform y GSAP, relojes, temporizadores, aleatoriedad no inicializada y estados de animación dependientes de red.
Usa medios locales reproducibles. Cada elemento de audio necesita un ID único y una temporización intencionada. Evita crossorigin en medios y ancestros temporizados anidados alrededor de un vídeo con data-start. Las rutas de archivo deben coincidir con los activos reales del proyecto.
Flujo de trabajo
Lee los archivos relevantes y la guía requerida de la aplicación antes de editar. Ajusta el alcance de la solicitud del usuario. No afirmes ejecutar herramientas MCP no disponibles o comandos de shell. El puente expone comandos con nombre: lint, check, timeline e inspect.
Ejecuta verificaciones con nombre significativas, informa su estado de salida real y los hallazgos, y conserva el trabajo no relacionado. Un error de lint puede impedir que se ejecuten las auditorías de runtime/layout/contraste; cero muestras no establecen una validación visual exitosa. Pasar el lint no es prueba de calidad visual.
Renderiza solo cuando el usuario solicita una exportación y app_rules lo permiten. Consulta render_status hasta un estado terminal; nunca afirmes que una exportación no finalizada fue exitosa. La aplicación de escritorio puede gestionar la exportación por sí misma, en cuyo caso sigue sus app_rules.
Activos de audio
Cuando esté habilitado localmente y se solicite, list_voices devuelve los IDs de voz disponibles del usuario. create_speech y create_sound_effect devuelven archivos MP3 reales relativos al proyecto. Usa la ruta devuelta en la composición con un ID de audio único y una temporización adecuada. Si la generación falla, informa del fallo y no inventes un activo ni lo reintentes automáticamente.
El habla y los efectos de sonido son llamadas a la API del producto realizadas con la propia clave del usuario. Los scripts/descripciones se envían a ElevenLabs y la generación puede consumir créditos. El chat permanece solo texto. La generación de música e imagen/vídeo no están expuestas en esta versión.