⚠ 계약 상태: 제작(craft)은 최신, 코드는 아님
이 스택의 출력 프레임워크는 Remotion + React (
/hyperframes-core)입니다. 여기의 모션 제작 지식은 여전히 유효합니다: 타이밍, 이징 선택, 움직임의 형태, 명명된 규칙과 청사진. 코드는 유효하지 않습니다: 예제와 어댑터는 더 이상 사용되지 않는 HTML + 일시 정지 GSAP 타임라인 런타임을 기준으로 작성되었습니다.읽으면서 다음과 같이 번역하세요:
여기 (이전 방식) Remotion에서의 방식 gsap.fromTo(el, {x:-40}, {x:0, duration:0.5})interpolate(frame, [0, SEC(0.5)], [-40, 0], {…"clamp"})ease: "back.out(1.7)"spring({frame, fps, config:{damping}}), 눈으로 조정window.__timelines[id]의 일시 정지 타임라인없음; 모든 값은 useCurrentFrame()의 함수클립의 data-start/data-duration<Sequence from>/durationInFrames(프레임 단위)CSS keyframe 또는 transition 프레임 기반 인라인 style(CSS 애니메이션은 렌더링되지 않음)이 스킬의 예제를 수정하지 않고 Remotion 프로젝트에 붙여넣지 마십시오.
HyperFrames 애니메이션
모든 모션 지식을 하나의 스킬로 제공합니다: 규칙(원자적 레시피), 청사진(다단계 씬 템플릿), 전환(씬 간 전환), 기법(광범위한 모션 디자인 패턴), 어댑터(런타임별 API).
컴포지션 계약(데이터 속성, 하위 컴포지션, 결정론)은 hyperframes-core를 참조하십시오.
기본값: 원자적 규칙 구성하기
rules-index.md에서 2-4개의 규칙을 선택하고, 단일 일시 정지 GSAP 타임라인으로 결합하면 됩니다. 이 방법이 청사진부터 시작하는 것보다 빠르고 코드가 적습니다.
청사진을 로드해야 하는 경우
- 현재 씬이 기존의 미리 설계된 다단계 템플릿(브랜드 리빌, 소셜 프루프 등)과 일치하고, 해당 단계 파이프라인을 재사용하는 것이 실제 제작 시간을 절약해주는 경우
- 복잡한 4~5단계 안무에 대해 실행 가능한 정확한 코드가 필요한 경우
청사진은 blueprints-index.md에 있습니다. 각 항목은 blueprints/<id>.md(레시피)를 가리킵니다. 추측성으로 읽지 마십시오. 씬 수준의 오케스트레이션이 필요하다고 결정한 후에 로드하십시오.
라우팅
| 원하는 작업 | 읽을 문서 |
|---|---|
| 트리거/태그별로 원자적 모션 패턴 선택 | rules-index.md |
| 특정 규칙의 전체 HTML / CSS / GSAP 레시피 읽기 | rules/<name>.md |
| 다단계 씬 템플릿 선택 | blueprints-index.md |
| 특정 청사진의 전체 레시피 읽기 | blueprints/<id>.md |
| 씬 전환 제작 (CSS 기반, 두 클립 사이) | transitions/overview.md, transitions/catalog.md |
| 광범위한 모션 디자인 기법 검색 | techniques.md |
| 기존 컴포지션의 애니메이션 맵 분석 | scripts/animation-map.mjs |
| GSAP API — 타임라인 / 트윈 / 위치 파라미터 | adapters/gsap.md |
| GSAP — 바로 사용 가능한 효과 레시피 | rules/gsap-effects.md |
| GSAP — 변환 / 성능 | adapters/gsap-transforms-and-perf.md |
| GSAP — 이징 / 스테거 | adapters/gsap-easing-and-stagger.md |
| GSAP — 타임라인 / 레이블 | adapters/gsap-timeline-and-labels.md |
Lottie / dotLottie (After Effects 내보내기, window.__hfLottie) | adapters/lottie.md |
Three.js / WebGL (3D 씬, AnimationMixer, hf-seek) | adapters/three.md |
Anime.js (window.__hfAnime) | adapters/animejs.md |
CSS keyframes (animation-delay / play-state / fill-mode) | adapters/css-animations.md |
Web Animations API (element.animate(), currentTime seek) | adapters/waapi.md |
TypeGPU / WebGPU (navigator.gpu, WGSL, 컴퓨트 파이프라인) | adapters/typegpu.md |
HTML-as-texture + WebGL/GLSL 포스트 FX (drawElementImage으로 라이브 DOM 캡처) | adapters/html-in-canvas-patterns.md |
명명된 텍스트 애니메이션 효과 (외부 animate-text 스킬을 통해 24개 ID) | adapters/animate-text.md |
런타임 선택하기
- GSAP는 95%의 모션 작업에 기본값입니다 — 타임라인 오케스트레이션, 변환, 이징, 스테거를 다룹니다. 이 스킬의 모든 원자적 규칙은 GSAP 기반입니다.
- Lottie는 자산에 미리 만들어진 타임라인이 있는 경우(일반적으로 After Effects 내보내기).
- Three.js는 3D 씬, 카메라 모션, 셰이더 기반 시각 효과용.
- Anime.js는 GSAP이 과도한 경우 가벼운 트위닝용.
- CSS는 단순 반복 패턴, 장식, 반짝임용 — JavaScript 애니메이션 비용 없음.
- WAAPI는 GSAP 의존성 없이 네이티브 브라우저 키프레임용.
- TypeGPU / WebGPU는 GPU 렌더링 캔버스(파티클, 액체 유리, 커스텀 셰이더)용.
여러 런타임이 하나의 컴포지션에 공존할 수 있습니다. 각 런타임은 인스턴스를 런타임별 전역 객체에 등록하여 HyperFrames가 한 번에 모두 seek할 수 있도록 합니다.
중요 제약 조건
전제 조건: hyperframes-core → 절대 타협할 수 없는 규칙(단일 일시 정지 타임라인, data-duration이 길이를 결정, Math.random / Date.now / performance.now 사용 금지, repeat: -1 사용 금지, 이후 씬 클립에 대한 페이지 로드 시 gsap.set 사용 금지, display 또는 원시 visibility 트윈 사용 금지, 그리고 async / setTimeout / Promise 내부의 타임라인 구성 금지). GSAP autoAlpha 및 명시적 타임라인 경계에서의 지속 시간 0 가시성 설정은 코어에서 계속 허용됩니다. 이러한 예외는 클립이 아닌 요소나 클립 내부의 래퍼에만 사용하십시오. 프레임워크가 .clip 라이프사이클을 소유합니다. 전체 계약을 여기에 다시 기술하지 마십시오.
코어의 계약에 추가되는 애니메이션 제작 규칙:
- 사전 계산된 레이아웃 상수 — 트윈 시간에
getBoundingClientRect()에서 위치를 유도하지 마십시오. 트윈 시간 DOM 측정은 렌더러가 병렬로 샘플링하기 때문에 동기화가 깨집니다. 컴포지션 설정 시 한 번 좌표를 계산하고 재사용하십시오. - 공간 모션은 GSAP 변환 별칭만 사용 (
x,y,scale,rotation). 코어의 허용 목록은 비공간 속성 트윈을 위해opacity/color/backgroundColor/borderRadius도 허용합니다 — 그러나 레이아웃 변경을 위한width/height/top/left는 절대 사용하지 마십시오.
스크립트
node skills/hyperframes-animation/scripts/animation-map.mjs <composition-dir> \
--out <composition-dir>/.hyperframes/anim-map
window.__timelines에 등록된 모든 GSAP 타임라인을 읽고, 트윈을 열거하고, 바운딩 박스를 샘플링하고, 플래그를 계산하여 animation-map.json을 출력합니다. 제작 후 안무(데드 존, 스테거 일관성, 라이프사이클 경고)를 감사하는 데 사용하십시오.
animation-map.mjs는 먼저 현재 프로젝트에서 헬퍼 패키지를 확인한 다음, 번들된 HyperFrames 패키지 버전을 부트스트랩할 수 있습니다. 번들된 CLI/스킬 설치 외부에서 스킬을 실행 중이고 해당 부트스트랩 버전을 명시적으로 고정해야 하는 경우에만 HYPERFRAMES_SKILL_PKG_VERSION=<version>을 설정하십시오.
참조
hyperframes-core— 컴포지션 구조, 데이터 속성, 하위 컴포지션, 결정론적 렌더링 계약hyperframes-creative— 팔레트, 타이포그래피, 내레이션, 비트 계획 (애니메이션이 아닌 크리에이티브 방향)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render