Referência de autoria HyperFrames para esta ponte
Esta referência concisa foi elaborada para o harness. A documentação completa do produto está no aplicativo desktop instalado e na documentação oficial do HyperFrames.
Composição
Um index.html independente tem uma raiz de composição diretamente no body. Use data-composition-id, data-width, data-height e um data-duration finito. CSS width/height na raiz são 100%; as dimensões do canvas pertencem aos seus atributos data. Uma subcomposição usa um template com seus estilos/scripts internos.
Dê aos clipes a classe "clip", data-start/data-duration intencionais e data-track-index. Uma track é uma faixa do Studio, não uma restrição de tempo ou z-index. A duração raiz deve incluir o final de todos os clipes pretendidos. Preserve temporizações, identificadores e mídias não relacionados ao editar.
Registre uma timeline GSAP pausada em window.__timelines[compositionId], usando o mesmo ID da raiz. Anime elementos internos; o framework controla a visibilidade do clipe e a busca de mídia. Não anime display, visibility ou autoAlpha do clipe. Evite conflitos CSS-transform/GSAP, clocks, timers, aleatoriedade não seed e estado de animação dependente de rede.
Use mídia local reproduzível. Cada elemento de áudio precisa de um ID único e temporização intencional. Evite crossorigin em mídia e ancestrais temporizados aninhados ao redor de um vídeo com data-start. Caminhos de arquivo devem corresponder aos ativos reais do projeto.
Fluxo de trabalho
Leia arquivos relevantes e o guia obrigatório do aplicativo antes de editar. Corresponda ao escopo da solicitação do usuário. Não afirme executar ferramentas MCP ou comandos shell indisponíveis. A ponte expõe comandos nomeados: lint, check, timeline e inspect.
Execute verificações nomeadas significativas, relate seu status de saída real e descobertas, e preserve trabalho não relacionado. Um erro de lint pode impedir que as auditorias de runtime/layout/contraste sejam executadas; amostras zero não estabelecem validação visual bem-sucedida. Passar no lint não é prova de qualidade visual.
Renderize apenas quando o usuário solicitar uma exportação e as app_rules permitirem. Consulte render_status até um estado terminal; nunca afirme que uma exportação inacabada foi bem-sucedida. O aplicativo desktop pode ser dono da exportação, caso em que siga suas app_rules.
Ativos de áudio
Quando ativado localmente e solicitado, list_voices retorna os IDs de voz disponíveis do usuário. create_speech e create_sound_effect retornam arquivos MP3 reais relativos ao projeto. Use um caminho retornado na composição com um ID de áudio único e temporização apropriada. Se a geração falhar, relate a falha e não invente um ativo nem tente novamente automaticamente.
Fala e efeitos sonoros são chamadas de API do produto feitas com a própria chave do usuário. Scripts/descrições são enviados para a ElevenLabs e a geração pode consumir créditos. O chat permanece apenas texto. Geração de música e imagem/vídeo não está exposta nesta versão.