gsap-effects — правило для Claude Code: GSAP-анимации HyperFrames
Правило gsap-effects для Claude Code и Codex с паттернами GSAP-анимаций в HyperFrames: typewriter и аудиовизуализация. Задаёт детерминированную покадровую отрисовку роликов.
AGPL-3.0 ★ 78 316 обновлён 2026-10-24
.claude/rules/gsap-effects.mdЧто делает gsap-effects
Правило описывает два самодостаточных эффекта: typewriter с посимвольным выводом текста и audio visualizer, который гонит Canvas или DOM-рендер из таймлайна. Каждый эффект — это HTML, CSS и JS в одном куске, без внешних зависимостей кроме GSAP.
Главное требование — детерминированность. Таймлайн регистрируется в window.__timelines, и никакой случайности в анимациях быть не должно. Поэтому для аудио нельзя использовать Web Audio API в момент рендера: воспроизведения при seek нет. Данные из аудио нужно извлечь заранее скриптом extract-audio-data.py, которому нужны ffmpeg и Python-библиотека numpy. Загрузка данных в страницу — только синхронная: fetch() сломает тайминг, потому что HyperFrames читает window.__timelines сразу после загрузки страницы.
В правиле разобраны тонкости typewriter: как моргать курсором, как делать backspace через удаление подстроки (TextPlugin стирает с начала, это не годится), как переносить курсор между строками. Для слов рядом со статичным текстом советуется margin-left на обёртке вместо flex gap — иначе курсор оторвётся от текста.
Какие задачи решает
- Сделать посимвольный вывод текста с мигающим курсором
- Запустить аудиовизуализацию из таймлайна без Web Audio API
- Извлечь громкость и частотные полосы из mp3 или mp4
- Собрать детерминированный таймлайн, который не ломается при seek
- Организовать перенос курсора между строками печатающегося текста
Примеры запросов агенту
- Добавь эффект печатающегося текста с мигающим курсором на сцену HyperFrames
- Сделай ротацию слов: печать, пауза, стирание, следующее слово
- Извлеки аудиоданные из video.mp4 и подключи визуализацию к таймлайну
Как установить gsap-effects
Вручную: положить файлы
.claude/rules/gsap-effects.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/gsap-effects.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/gsap-effects.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/gsap-effects.mdВручную: положить файлы
.clinerules/gsap-effects.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о gsap-effects
Как установить gsap-effects в Claude Code?
Добавь правило в файл .claude/rules/gsap-effects.md проекта. Агент подхватит его при следующем запуске.
Зачем нужен gsap-effects?
Он даёт готовые паттерны GSAP-анимаций, которые вписываются в seek-driven контракт HyperFrames. Без них легко сломать детерминированность: асинхронная загрузка данных или случайные значения в анимациях не дадут таймлайну корректно перематываться.
Что нужно для аудиовизуализации?
Понадобится Python с библиотекой numpy и ffmpeg в PATH. Скрипт extract-audio-data.py извлекает данные из аудио или видео в JSON, который затем загружается в страницу синхронно.