Registre HyperFrames
Le registre fournit des blocks et composants réutilisables installables via hyperframes add <nom>.
- Blocks — sous-compositions autonomes (dimensions, durée, timeline propres). Inclus via
data-composition-srcdans une composition hôte. - Composants — snippets d'effets (pas de dimensions propres). Collés directement dans le HTML d'une composition hôte.
Quand utiliser ce skill
- L'utilisateur mentionne
hyperframes add, "block", "composant", ouhyperframes.json - La sortie de
hyperframes addapparaît dans la session (chemins de fichiers, snippet dans le presse-papier) - Vous devez câbler un élément installé dans une composition existante
- Vous souhaitez découvrir ce qui est disponible dans le registre
Référence rapide
hyperframes add data-chart # installer un block
hyperframes add grain-overlay # installer un composant
hyperframes add shimmer-sweep --dir . # cibler un projet spécifique
hyperframes add data-chart --json # sortie lisible par machine
hyperframes add data-chart --no-clipboard # ignorer le presse-papier (CI/sans tête)
Après l'installation, la CLI affiche les fichiers écrits et un snippet à coller dans votre composition hôte. Le snippet est un point de départ — vous devrez ajouter les attributs data-composition-id (doit correspondre à l'ID interne du block), data-start, et data-track-index lors du câblage des blocks.
Remarque : hyperframes add fonctionne uniquement pour les blocks et composants. Pour les exemples, utilisez hyperframes init <dossier> --example <nom> à la place.
Emplacements d'installation
Les blocks s'installent dans compositions/<nom>.html par défaut.
Les composants s'installent dans compositions/components/<nom>.html par défaut.
Ces chemins sont configurables dans hyperframes.json :
{
"registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
"paths": {
"blocks": "compositions",
"components": "compositions/components",
"assets": "assets"
}
}
Voir install-locations.md pour les détails complets.
Câblage des blocks
Les blocks sont des compositions autonomes — incluez-les via data-composition-src dans votre index.html hôte :
<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>
Attributs clés :
data-composition-src— chemin vers le fichier HTML du blockdata-composition-id— doit correspondre à l'ID interne du blockdata-start— quand le block apparaît dans la timeline hôte (en secondes)data-duration— durée de lecture du blockdata-width/data-height— dimensions du canvas du blockdata-track-index— ordre des couches (plus élevé = devant)
Voir wiring-blocks.md pour les détails complets.
Câblage des composants
Les composants sont des snippets — collez leur HTML dans le balisage de votre composition, leur CSS dans votre bloc de styles, et leur JS dans votre script (le cas échéant) :
- Lisez le fichier installé (ex. :
compositions/components/grain-overlay.html) - Copiez les éléments HTML dans votre
<div data-composition-id="..."> - Copiez le bloc
<style>dans les styles de votre composition - Copiez tout contenu
<script>dans le script de votre composition (avant votre code de timeline) - Si le composant expose une intégration de timeline GSAP (voir le bloc de commentaire dans le snippet), ajoutez ces appels à votre timeline
Voir wiring-components.md pour les détails complets.
Découverte
Parcourez les éléments disponibles :
# Lire le manifeste du registre
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json
Chaque registry-item.json contient : nom, type, titre, description, tags, dimensions (blocks uniquement), durée (blocks uniquement), et liste de fichiers.
Voir discovery.md pour les détails sur le filtrage par type et tags.