# gsap-effects

Правило gsap-effects для Claude Code и Codex с паттернами GSAP-анимаций в HyperFrames: typewriter и аудиовизуализация. Задаёт детерминированную покадровую отрисовку роликов.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 78316 у репозитория
- Автор: calesthio
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/hyperframes-animation/rules/gsap-effects.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/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` — иначе курсор оторвётся от текста.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/rules/gsap-effects.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/gsap-effects.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/gsap-effects.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/gsap-effects.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/gsap-effects.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/hyperframes-animation/rules/gsap-effects.md

## Когда брать
- Сделать посимвольный вывод текста с мигающим курсором
- Запустить аудиовизуализацию из таймлайна без Web Audio API
- Извлечь громкость и частотные полосы из mp3 или mp4
- Собрать детерминированный таймлайн, который не ломается при seek
- Организовать перенос курсора между строками печатающегося текста

## Примеры запросов агенту
- Добавь эффект печатающегося текста с мигающим курсором на сцену HyperFrames
- Сделай ротацию слов: печать, пауза, стирание, следующее слово
- Извлеки аудиоданные из video.mp4 и подключи визуализацию к таймлайну

## Похожие
- [gsap](https://affpapa.org/nevibecode/skills/gsap.md) — скилл · 3 установки
- [gsap-plugins](https://affpapa.org/nevibecode/skills/gsap-plugins.md) — скилл · 81000 установок
- [gsap-utils](https://affpapa.org/nevibecode/skills/gsap-utils.md) — скилл · 78400 установок
- [gsap-react](https://affpapa.org/nevibecode/skills/bbeierle12-gsap-react.md) — скилл · 728 установок
- [hyperframes](https://affpapa.org/nevibecode/skills/heygen-com-hyperframes.md) — скилл · 1600000 установок
- [gsap-router](https://affpapa.org/nevibecode/skills/gsap-router.md) — скилл · 102 установки

Из того же набора: [calesthio/openmontage](https://affpapa.org/nevibecode/by/calesthio/openmontage.md) — 101 карточка

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
