HyperFrames 레지스트리
레지스트리는 hyperframes add <name> 명령으로 설치할 수 있는 재사용 가능한 블록과 컴포넌트를 제공합니다.
- 블록(Blocks) — 독립형 서브-컴포지션(자체 디멘션, 지속 시간, 타임라인 포함). 호스트 컴포지션에서
data-composition-src를 통해 포함됩니다. - 컴포넌트(Components) — 이펙트 스니펫(자체 디멘션 없음). 호스트 컴포지션의 HTML에 직접 붙여넣기 됩니다.
이 스킬을 사용하는 경우
- 사용자가
hyperframes add, "블록", "컴포넌트" 또는hyperframes.json을 언급할 때 hyperframes add의 출력(파일 경로, 클립보드 스니펫)이 세션에 나타날 때- 설치된 항목을 기존 컴포지션에 연결(wire)해야 할 때
- 레지스트리에서 사용 가능한 항목을 검색하고자 할 때
빠른 참조
hyperframes add data-chart # 블록 설치
hyperframes add grain-overlay # 컴포넌트 설치
hyperframes add shimmer-sweep --dir . # 특정 프로젝트 대상
hyperframes add data-chart --json # 기계가 읽을 수 있는 출력
hyperframes add data-chart --no-clipboard # 클립보드 생략 (CI/headless)
설치 후 CLI는 작성된 파일과 호스트 컴포지션에 붙여넣을 스니펫을 출력합니다. 스니펫은 시작점일 뿐이며, 블록을 연결할 때는 data-composition-id (블록의 내부 컴포지션 ID와 일치해야 함), data-start, data-track-index 속성을 추가해야 합니다.
참고: hyperframes add는 블록과 컴포넌트에만 작동합니다. 예제의 경우 hyperframes init <dir> --example <name>을 사용하세요.
설치 위치
블록은 기본적으로 compositions/<name>.html에 설치됩니다.
컴포넌트는 기본적으로 compositions/components/<name>.html에 설치됩니다.
이 경로는 hyperframes.json에서 설정할 수 있습니다:
{
"registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
"paths": {
"blocks": "compositions",
"components": "compositions/components",
"assets": "assets"
}
}
자세한 내용은 install-locations.md를 참조하세요.
블록 연결하기
블록은 독립형 컴포지션입니다. 호스트 index.html에서 data-composition-src를 통해 포함하세요:
<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>
주요 속성:
data-composition-src— 블록 HTML 파일의 경로data-composition-id— 블록의 내부 ID와 일치해야 함data-start— 블록이 호스트 타임라인에 나타나는 시간(초)data-duration— 블록이 재생되는 시간data-width/data-height— 블록 캔버스 크기data-track-index— 레이어 순서(높을수록 앞에 위치)
자세한 내용은 wiring-blocks.md를 참조하세요.
컴포넌트 연결하기
컴포넌트는 스니펫입니다. 해당 HTML을 컴포지션의 마크업에, CSS를 스타일 블록에, JS를 스크립트(있는 경우)에 붙여넣으세요:
- 설치된 파일 읽기 (예:
compositions/components/grain-overlay.html) - HTML 요소를 컴포지션의
<div data-composition-id="...">에 복사 <style>블록을 컴포지션의 스타일에 복사<script>내용을 컴포지션의 스크립트(타임라인 코드 앞)에 복사- 컴포넌트가 GSAP 타임라인 통합을 제공하는 경우(스니펫의 주석 블록 참조), 해당 호출을 타임라인에 추가
자세한 내용은 wiring-components.md를 참조하세요.
검색
사용 가능한 항목 탐색:
# 레지스트리 매니페스트 읽기
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json
각 항목의 registry-item.json에는 이름, 유형, 제목, 설명, 태그, 디멘션(블록만 해당), 지속 시간(블록만 해당), 파일 목록이 포함됩니다.
유형 및 태그별 필터링에 대한 자세한 내용은 discovery.md를 참조하세요.