@mevdragon/vidfarm-devcli 0.14.0 → 0.16.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/skills/embedded-captions/CATALOG.md +93 -0
- package/.agents/skills/embedded-captions/SKILL.md +286 -0
- package/.agents/skills/embedded-captions/assets/brand/CDPR-fankit-terms.txt +35 -0
- package/.agents/skills/embedded-captions/assets/brand/cyberpunk-widths.json +115 -0
- package/.agents/skills/embedded-captions/assets/fonts/char-widths.json +2211 -0
- package/.agents/skills/embedded-captions/assets/strokefonts/HersheyScript1.svg +242 -0
- package/.agents/skills/embedded-captions/assets/strokefonts/HersheyScriptMed.svg +242 -0
- package/.agents/skills/embedded-captions/dna/README.md +148 -0
- package/.agents/skills/embedded-captions/dna/chrome.json +68 -0
- package/.agents/skills/embedded-captions/dna/cream.json +69 -0
- package/.agents/skills/embedded-captions/dna/documentary.json +62 -0
- package/.agents/skills/embedded-captions/dna/editorial.json +70 -0
- package/.agents/skills/embedded-captions/dna/glitch.json +82 -0
- package/.agents/skills/embedded-captions/dna/ink.json +65 -0
- package/.agents/skills/embedded-captions/dna/keynote.json +62 -0
- package/.agents/skills/embedded-captions/dna/loud.json +75 -0
- package/.agents/skills/embedded-captions/dna/neon.json +58 -0
- package/.agents/skills/embedded-captions/dna/velocity.json +89 -0
- package/.agents/skills/embedded-captions/modes/cinematic/README.md +48 -0
- package/.agents/skills/embedded-captions/modes/cinematic/_archive/champion/spec.md +98 -0
- package/.agents/skills/embedded-captions/modes/cinematic/_archive/champion/template.html +188 -0
- package/.agents/skills/embedded-captions/modes/cinematic/_archive/memory-wall/spec.md +134 -0
- package/.agents/skills/embedded-captions/modes/cinematic/_archive/memory-wall/template.html +179 -0
- package/.agents/skills/embedded-captions/modes/cinematic/_archive/portrait-header/spec.md +81 -0
- package/.agents/skills/embedded-captions/modes/cinematic/_archive/portrait-header/template.html +170 -0
- package/.agents/skills/embedded-captions/modes/cinematic/cinematic-cream/spec.md +16 -0
- package/.agents/skills/embedded-captions/modes/cinematic/cinematic-cream/template.html +226 -0
- package/.agents/skills/embedded-captions/modes/cinematic/engine.html +355 -0
- package/.agents/skills/embedded-captions/modes/standard/_anatomy.md +233 -0
- package/.agents/skills/embedded-captions/modes/standard/_motion.md +192 -0
- package/.agents/skills/embedded-captions/modes/standard/fonts/build-fonts-css.cjs +97 -0
- package/.agents/skills/embedded-captions/references/aesthetic-principles.md +168 -0
- package/.agents/skills/embedded-captions/references/anti-patterns.md +188 -0
- package/.agents/skills/embedded-captions/references/bespoke-vs-presets.md +178 -0
- package/.agents/skills/embedded-captions/references/caption-grouping.md +130 -0
- package/.agents/skills/embedded-captions/references/composition-craft.md +522 -0
- package/.agents/skills/embedded-captions/references/direction-catalog.md +138 -0
- package/.agents/skills/embedded-captions/references/example-renders/champion.html +371 -0
- package/.agents/skills/embedded-captions/references/example-renders/memory-wall.html +334 -0
- package/.agents/skills/embedded-captions/references/failure-modes.md +145 -0
- package/.agents/skills/embedded-captions/references/layout-heuristics.md +238 -0
- package/.agents/skills/embedded-captions/references/motion-vocabulary.md +148 -0
- package/.agents/skills/embedded-captions/references/rail.md +68 -0
- package/.agents/skills/embedded-captions/references/reference-bar.md +47 -0
- package/.agents/skills/embedded-captions/references/scene-types.md +94 -0
- package/.agents/skills/embedded-captions/references/test-set.md +66 -0
- package/.agents/skills/embedded-captions/references/typographic-moves.md +266 -0
- package/.agents/skills/embedded-captions/references/typography-presets.md +63 -0
- package/.agents/skills/embedded-captions/scripts/audio-envelope.cjs +95 -0
- package/.agents/skills/embedded-captions/scripts/check-occlusion.cjs +250 -0
- package/.agents/skills/embedded-captions/scripts/check-overflow.cjs +194 -0
- package/.agents/skills/embedded-captions/scripts/check-rail-climax.cjs +233 -0
- package/.agents/skills/embedded-captions/scripts/check-timing.cjs +173 -0
- package/.agents/skills/embedded-captions/scripts/fill-timings.cjs +124 -0
- package/.agents/skills/embedded-captions/scripts/fit-fonts.cjs +158 -0
- package/.agents/skills/embedded-captions/scripts/gen-stroke-path.py +46 -0
- package/.agents/skills/embedded-captions/scripts/inject-fonts.cjs +169 -0
- package/.agents/skills/embedded-captions/scripts/lib-dna.cjs +201 -0
- package/.agents/skills/embedded-captions/scripts/make-cinematic.cjs +1205 -0
- package/.agents/skills/embedded-captions/scripts/make-composition.cjs +404 -0
- package/.agents/skills/embedded-captions/scripts/make-theme.cjs +8781 -0
- package/.agents/skills/embedded-captions/scripts/matte.cjs +294 -0
- package/.agents/skills/embedded-captions/scripts/measure-layout.cjs +293 -0
- package/.agents/skills/embedded-captions/scripts/prepare.sh +39 -0
- package/.agents/skills/embedded-captions/scripts/preview-frames.cjs +268 -0
- package/.agents/skills/embedded-captions/scripts/render-and-composite.sh +509 -0
- package/.agents/skills/embedded-captions/scripts/render-theme.sh +34 -0
- package/.agents/skills/embedded-captions/scripts/safe-zones.cjs +813 -0
- package/.agents/skills/embedded-captions/scripts/transcribe.cjs +349 -0
- package/.agents/skills/embedded-captions/themes/PORTING.md +49 -0
- package/.agents/skills/embedded-captions/themes/README.md +244 -0
- package/.agents/skills/embedded-captions/themes/anchor.json +27 -0
- package/.agents/skills/embedded-captions/themes/arcade.json +51 -0
- package/.agents/skills/embedded-captions/themes/aurora.json +41 -0
- package/.agents/skills/embedded-captions/themes/biolume.json +35 -0
- package/.agents/skills/embedded-captions/themes/brush.json +74 -0
- package/.agents/skills/embedded-captions/themes/chalkboard.json +52 -0
- package/.agents/skills/embedded-captions/themes/dossier.json +56 -0
- package/.agents/skills/embedded-captions/themes/graffiti.json +62 -0
- package/.agents/skills/embedded-captions/themes/hologram.json +41 -0
- package/.agents/skills/embedded-captions/themes/inkwater.json +43 -0
- package/.agents/skills/embedded-captions/themes/laser.json +46 -0
- package/.agents/skills/embedded-captions/themes/lastpage.json +33 -0
- package/.agents/skills/embedded-captions/themes/neonsign.json +53 -0
- package/.agents/skills/embedded-captions/themes/nightcity.json +56 -0
- package/.agents/skills/embedded-captions/themes/ordnance.json +54 -0
- package/.agents/skills/embedded-captions/themes/papercut.json +37 -0
- package/.agents/skills/embedded-captions/themes/popup.json +46 -0
- package/.agents/skills/embedded-captions/themes/ransom.json +62 -0
- package/.agents/skills/embedded-captions/themes/scoreboard.json +54 -0
- package/.agents/skills/embedded-captions/themes/spectrum.json +46 -0
- package/.agents/skills/embedded-captions/themes/stardust.json +29 -0
- package/.agents/skills/embedded-captions/themes/stomp.json +43 -0
- package/.agents/skills/embedded-captions/themes/terminal.json +49 -0
- package/.agents/skills/embedded-captions/themes/thunder.json +44 -0
- package/.agents/skills/embedded-captions/themes/transit.json +44 -0
- package/.agents/skills/embedded-captions/themes/vhs.json +47 -0
- package/.agents/skills/faceless-explainer/SKILL.md +209 -0
- package/.agents/skills/faceless-explainer/references/cut-catalog.md +215 -0
- package/.agents/skills/faceless-explainer/references/motion-language.md +156 -0
- package/.agents/skills/faceless-explainer/references/story-design.md +248 -0
- package/.agents/skills/faceless-explainer/references/visual-design.md +146 -0
- package/.agents/skills/faceless-explainer/scripts/assemble-index.mjs +570 -0
- package/.agents/skills/faceless-explainer/scripts/audio.mjs +260 -0
- package/.agents/skills/faceless-explainer/scripts/build-frame.mjs +536 -0
- package/.agents/skills/faceless-explainer/scripts/captions.mjs +508 -0
- package/.agents/skills/faceless-explainer/scripts/lib/assets.mjs +55 -0
- package/.agents/skills/faceless-explainer/scripts/lib/dimensions.mjs +45 -0
- package/.agents/skills/faceless-explainer/scripts/lib/storyboard.mjs +249 -0
- package/.agents/skills/faceless-explainer/scripts/lib/tokens.mjs +204 -0
- package/.agents/skills/faceless-explainer/scripts/lib/transition-registry.mjs +38 -0
- package/.agents/skills/faceless-explainer/scripts/lib/transitions.json +71 -0
- package/.agents/skills/faceless-explainer/scripts/transitions.mjs +320 -0
- package/.agents/skills/faceless-explainer/sub-agents/frame-worker.md +75 -0
- package/.agents/skills/flockposter/LICENSE +17 -0
- package/.agents/skills/flockposter/README.md +72 -0
- package/.agents/skills/flockposter/SKILL.md +562 -0
- package/.agents/skills/flockposter/examples/cli-instagram-reel.sh +21 -0
- package/.agents/skills/flockposter/examples/cli-multi-platform.json +69 -0
- package/.agents/skills/flockposter/examples/cli-tiktok-upload-only.sh +22 -0
- package/.agents/skills/flockposter/examples/cli-x-thread.sh +17 -0
- package/.agents/skills/flockposter/examples/cli-youtube-short.sh +21 -0
- package/.agents/skills/flockposter/examples/public-api-instagram-reel.json +28 -0
- package/.agents/skills/general-video/SKILL.md +143 -0
- package/.agents/skills/hyperframes/SKILL.md +160 -0
- package/.agents/skills/hyperframes-animation/SKILL.md +84 -0
- package/.agents/skills/hyperframes-animation/adapters/animate-text.md +64 -0
- package/.agents/skills/hyperframes-animation/adapters/animejs.md +114 -0
- package/.agents/skills/hyperframes-animation/adapters/css-animations.md +143 -0
- package/.agents/skills/hyperframes-animation/adapters/gsap-easing-and-stagger.md +118 -0
- package/.agents/skills/hyperframes-animation/adapters/gsap-timeline-and-labels.md +96 -0
- package/.agents/skills/hyperframes-animation/adapters/gsap-transforms-and-perf.md +96 -0
- package/.agents/skills/hyperframes-animation/adapters/gsap.md +105 -0
- package/.agents/skills/hyperframes-animation/adapters/html-in-canvas-patterns.md +507 -0
- package/.agents/skills/hyperframes-animation/adapters/lottie.md +117 -0
- package/.agents/skills/hyperframes-animation/adapters/three.md +131 -0
- package/.agents/skills/hyperframes-animation/adapters/typegpu.md +178 -0
- package/.agents/skills/hyperframes-animation/adapters/waapi.md +101 -0
- package/.agents/skills/hyperframes-animation/blueprints/comparison-split.md +27 -0
- package/.agents/skills/hyperframes-animation/blueprints/constellation-hub.md +44 -0
- package/.agents/skills/hyperframes-animation/blueprints/cta-morph-press.md +28 -0
- package/.agents/skills/hyperframes-animation/blueprints/cursor-ui-demo.md +57 -0
- package/.agents/skills/hyperframes-animation/blueprints/dataviz-countup.md +46 -0
- package/.agents/skills/hyperframes-animation/blueprints/device-surface-showcase.md +53 -0
- package/.agents/skills/hyperframes-animation/blueprints/grid-card-assemble.md +66 -0
- package/.agents/skills/hyperframes-animation/blueprints/kinetic-type-beats.md +78 -0
- package/.agents/skills/hyperframes-animation/blueprints/logo-assemble-lockup.md +69 -0
- package/.agents/skills/hyperframes-animation/blueprints/overwhelm-surround.md +28 -0
- package/.agents/skills/hyperframes-animation/blueprints/spatial-pan-stations.md +37 -0
- package/.agents/skills/hyperframes-animation/blueprints/ticker-takeover.md +29 -0
- package/.agents/skills/hyperframes-animation/blueprints/titlecard-reveal.md +42 -0
- package/.agents/skills/hyperframes-animation/blueprints/typewriter-reveal.md +51 -0
- package/.agents/skills/hyperframes-animation/blueprints/video-text-pivot.md +30 -0
- package/.agents/skills/hyperframes-animation/blueprints-index.md +146 -0
- package/.agents/skills/hyperframes-animation/examples/assets/avatars/02.avif +0 -0
- package/.agents/skills/hyperframes-animation/examples/assets/brands/github.avif +0 -0
- package/.agents/skills/hyperframes-animation/examples/assets/brands/nvidia.avif +0 -0
- package/.agents/skills/hyperframes-animation/examples/assets/brands/visa.avif +0 -0
- package/.agents/skills/hyperframes-animation/examples/assets/brands/zoominfo.avif +0 -0
- package/.agents/skills/hyperframes-animation/examples/brand-reveal-assemble-zoom.html +382 -0
- package/.agents/skills/hyperframes-animation/examples/comparison-split-cards.html +649 -0
- package/.agents/skills/hyperframes-animation/examples/concept-demo-decode-pan.html +520 -0
- package/.agents/skills/hyperframes-animation/examples/cta-morph-press.html +468 -0
- package/.agents/skills/hyperframes-animation/examples/cta-orbit-collapse.html +1298 -0
- package/.agents/skills/hyperframes-animation/examples/demo-page-scroll-spotlight.html +759 -0
- package/.agents/skills/hyperframes-animation/examples/hook-counter-burst.html +729 -0
- package/.agents/skills/hyperframes-animation/examples/messaging-multi-phrase.html +352 -0
- package/.agents/skills/hyperframes-animation/examples/metric-video-text-pivot.html +779 -0
- package/.agents/skills/hyperframes-animation/examples/problem-mockup-overwhelm.html +1374 -0
- package/.agents/skills/hyperframes-animation/examples/proof-logo-chain.html +861 -0
- package/.agents/skills/hyperframes-animation/examples/takeover-ticker-displace.html +347 -0
- package/.agents/skills/hyperframes-animation/examples/workflow-approve-press.html +606 -0
- package/.agents/skills/hyperframes-animation/rules/3d-page-scroll.md +227 -0
- package/.agents/skills/hyperframes-animation/rules/3d-text-depth-layers.md +297 -0
- package/.agents/skills/hyperframes-animation/rules/ai-tracking-box.md +382 -0
- package/.agents/skills/hyperframes-animation/rules/ambient-glow-bloom.md +305 -0
- package/.agents/skills/hyperframes-animation/rules/asr-keyword-glow.md +286 -0
- package/.agents/skills/hyperframes-animation/rules/avatar-cloud-network.md +371 -0
- package/.agents/skills/hyperframes-animation/rules/camera-cursor-tracking.md +246 -0
- package/.agents/skills/hyperframes-animation/rules/card-morph-anchor.md +267 -0
- package/.agents/skills/hyperframes-animation/rules/center-outward-expansion.md +227 -0
- package/.agents/skills/hyperframes-animation/rules/context-sensitive-cursor.md +257 -0
- package/.agents/skills/hyperframes-animation/rules/coordinate-target-zoom.md +332 -0
- package/.agents/skills/hyperframes-animation/rules/counting-dynamic-scale.md +283 -0
- package/.agents/skills/hyperframes-animation/rules/css-marker-patterns.md +373 -0
- package/.agents/skills/hyperframes-animation/rules/cursor-click-ripple.md +262 -0
- package/.agents/skills/hyperframes-animation/rules/depth-of-field-blur.md +313 -0
- package/.agents/skills/hyperframes-animation/rules/depth-scatter-assemble.md +303 -0
- package/.agents/skills/hyperframes-animation/rules/discrete-text-sequence.md +273 -0
- package/.agents/skills/hyperframes-animation/rules/dynamic-content-sequencing.md +307 -0
- package/.agents/skills/hyperframes-animation/rules/gsap-effects.md +299 -0
- package/.agents/skills/hyperframes-animation/rules/hacker-flip-3d.md +223 -0
- package/.agents/skills/hyperframes-animation/rules/kinetic-beat-slam.md +183 -0
- package/.agents/skills/hyperframes-animation/rules/motion-blur-streak.md +328 -0
- package/.agents/skills/hyperframes-animation/rules/multi-phase-camera.md +273 -0
- package/.agents/skills/hyperframes-animation/rules/orbit-3d-entry.md +301 -0
- package/.agents/skills/hyperframes-animation/rules/physics-press-reaction.md +350 -0
- package/.agents/skills/hyperframes-animation/rules/press-release-spring.md +296 -0
- package/.agents/skills/hyperframes-animation/rules/reactive-displacement.md +277 -0
- package/.agents/skills/hyperframes-animation/rules/scale-swap-transition.md +298 -0
- package/.agents/skills/hyperframes-animation/rules/sine-wave-loop.md +278 -0
- package/.agents/skills/hyperframes-animation/rules/split-tilt-cards.md +277 -0
- package/.agents/skills/hyperframes-animation/rules/spring-pop-entrance.md +273 -0
- package/.agents/skills/hyperframes-animation/rules/stat-bars-and-fills.md +156 -0
- package/.agents/skills/hyperframes-animation/rules/svg-icon-enrichment.md +329 -0
- package/.agents/skills/hyperframes-animation/rules/svg-path-draw.md +274 -0
- package/.agents/skills/hyperframes-animation/rules/vertical-spring-ticker.md +239 -0
- package/.agents/skills/hyperframes-animation/rules/viewport-change.md +349 -0
- package/.agents/skills/hyperframes-animation/rules-index.md +86 -0
- package/.agents/skills/hyperframes-animation/scripts/animation-map.mjs +606 -0
- package/.agents/skills/hyperframes-animation/scripts/package-loader.mjs +288 -0
- package/.agents/skills/hyperframes-animation/scripts/package-loader.test.mjs +62 -0
- package/.agents/skills/hyperframes-animation/techniques.md +507 -0
- package/.agents/skills/hyperframes-animation/transitions/TRANSITION-REGISTRY.md +167 -0
- package/.agents/skills/hyperframes-animation/transitions/catalog.md +127 -0
- package/.agents/skills/hyperframes-animation/transitions/css-3d.md +12 -0
- package/.agents/skills/hyperframes-animation/transitions/css-blur.md +51 -0
- package/.agents/skills/hyperframes-animation/transitions/css-cover.md +43 -0
- package/.agents/skills/hyperframes-animation/transitions/css-destruction.md +95 -0
- package/.agents/skills/hyperframes-animation/transitions/css-dissolve.md +66 -0
- package/.agents/skills/hyperframes-animation/transitions/css-distortion.md +45 -0
- package/.agents/skills/hyperframes-animation/transitions/css-grid.md +10 -0
- package/.agents/skills/hyperframes-animation/transitions/css-light.md +49 -0
- package/.agents/skills/hyperframes-animation/transitions/css-mechanical.md +30 -0
- package/.agents/skills/hyperframes-animation/transitions/css-other.md +25 -0
- package/.agents/skills/hyperframes-animation/transitions/css-push.md +41 -0
- package/.agents/skills/hyperframes-animation/transitions/css-radial.md +37 -0
- package/.agents/skills/hyperframes-animation/transitions/css-scale.md +24 -0
- package/.agents/skills/hyperframes-animation/transitions/overview.md +153 -0
- package/.agents/skills/hyperframes-cli/SKILL.md +113 -0
- package/.agents/skills/hyperframes-cli/references/doctor-browser.md +45 -0
- package/.agents/skills/hyperframes-cli/references/init-and-scaffold.md +55 -0
- package/.agents/skills/hyperframes-cli/references/lambda.md +132 -0
- package/.agents/skills/hyperframes-cli/references/lint-validate-inspect.md +121 -0
- package/.agents/skills/hyperframes-cli/references/preview-render.md +149 -0
- package/.agents/skills/hyperframes-cli/references/upgrade-info-misc.md +75 -0
- package/.agents/skills/hyperframes-core/SKILL.md +78 -0
- package/.agents/skills/hyperframes-core/references/composition-patterns.md +263 -0
- package/.agents/skills/hyperframes-core/references/data-attributes.md +70 -0
- package/.agents/skills/hyperframes-core/references/determinism-rules.md +68 -0
- package/.agents/skills/hyperframes-core/references/full-screen-motion.md +62 -0
- package/.agents/skills/hyperframes-core/references/minimal-composition.md +66 -0
- package/.agents/skills/hyperframes-core/references/script-format.md +49 -0
- package/.agents/skills/hyperframes-core/references/storyboard-format.md +95 -0
- package/.agents/skills/hyperframes-core/references/sub-compositions.md +237 -0
- package/.agents/skills/hyperframes-core/references/subagent-dispatch.md +41 -0
- package/.agents/skills/hyperframes-core/references/tailwind.md +125 -0
- package/.agents/skills/hyperframes-core/references/tracks-and-clips.md +76 -0
- package/.agents/skills/hyperframes-core/references/variables-and-media.md +90 -0
- package/.agents/skills/hyperframes-creative/SKILL.md +70 -0
- package/.agents/skills/hyperframes-creative/frame-presets/biennale-yellow/FRAME.md +289 -0
- package/.agents/skills/hyperframes-creative/frame-presets/biennale-yellow/caption-skin.html +221 -0
- package/.agents/skills/hyperframes-creative/frame-presets/biennale-yellow/frame-showcase.html +1214 -0
- package/.agents/skills/hyperframes-creative/frame-presets/blockframe/FRAME.md +275 -0
- package/.agents/skills/hyperframes-creative/frame-presets/blockframe/caption-skin.html +224 -0
- package/.agents/skills/hyperframes-creative/frame-presets/blockframe/frame-showcase.html +1347 -0
- package/.agents/skills/hyperframes-creative/frame-presets/blue-professional/FRAME.md +307 -0
- package/.agents/skills/hyperframes-creative/frame-presets/blue-professional/caption-skin.html +223 -0
- package/.agents/skills/hyperframes-creative/frame-presets/blue-professional/frame-showcase.html +1372 -0
- package/.agents/skills/hyperframes-creative/frame-presets/bold-poster/FRAME.md +275 -0
- package/.agents/skills/hyperframes-creative/frame-presets/bold-poster/caption-skin.html +230 -0
- package/.agents/skills/hyperframes-creative/frame-presets/bold-poster/frame-showcase.html +1140 -0
- package/.agents/skills/hyperframes-creative/frame-presets/broadside/FRAME.md +284 -0
- package/.agents/skills/hyperframes-creative/frame-presets/broadside/caption-skin.html +225 -0
- package/.agents/skills/hyperframes-creative/frame-presets/broadside/frame-showcase.html +1166 -0
- package/.agents/skills/hyperframes-creative/frame-presets/capsule/FRAME.md +284 -0
- package/.agents/skills/hyperframes-creative/frame-presets/capsule/caption-skin.html +224 -0
- package/.agents/skills/hyperframes-creative/frame-presets/capsule/frame-showcase.html +1465 -0
- package/.agents/skills/hyperframes-creative/frame-presets/cartesian/FRAME.md +278 -0
- package/.agents/skills/hyperframes-creative/frame-presets/cartesian/caption-skin.html +222 -0
- package/.agents/skills/hyperframes-creative/frame-presets/cartesian/frame-showcase.html +1263 -0
- package/.agents/skills/hyperframes-creative/frame-presets/claude/FRAME.md +277 -0
- package/.agents/skills/hyperframes-creative/frame-presets/claude/caption-skin.html +224 -0
- package/.agents/skills/hyperframes-creative/frame-presets/claude/frame-showcase.html +1439 -0
- package/.agents/skills/hyperframes-creative/frame-presets/cobalt-grid/FRAME.md +265 -0
- package/.agents/skills/hyperframes-creative/frame-presets/cobalt-grid/caption-skin.html +238 -0
- package/.agents/skills/hyperframes-creative/frame-presets/cobalt-grid/frame-showcase.html +1468 -0
- package/.agents/skills/hyperframes-creative/frame-presets/coral/FRAME.md +314 -0
- package/.agents/skills/hyperframes-creative/frame-presets/coral/caption-skin.html +226 -0
- package/.agents/skills/hyperframes-creative/frame-presets/coral/frame-showcase.html +1268 -0
- package/.agents/skills/hyperframes-creative/frame-presets/creative-mode/FRAME.md +333 -0
- package/.agents/skills/hyperframes-creative/frame-presets/creative-mode/caption-skin.html +227 -0
- package/.agents/skills/hyperframes-creative/frame-presets/creative-mode/frame-showcase.html +1330 -0
- package/.agents/skills/hyperframes-creative/frame-presets/daisy-days/FRAME.md +274 -0
- package/.agents/skills/hyperframes-creative/frame-presets/daisy-days/caption-skin.html +230 -0
- package/.agents/skills/hyperframes-creative/frame-presets/daisy-days/frame-showcase.html +1444 -0
- package/.agents/skills/hyperframes-creative/frame-presets/editorial-forest/FRAME.md +265 -0
- package/.agents/skills/hyperframes-creative/frame-presets/editorial-forest/caption-skin.html +223 -0
- package/.agents/skills/hyperframes-creative/frame-presets/editorial-forest/frame-showcase.html +1273 -0
- package/.agents/skills/hyperframes-creative/palettes/bold-energetic.md +14 -0
- package/.agents/skills/hyperframes-creative/palettes/clean-corporate.md +14 -0
- package/.agents/skills/hyperframes-creative/palettes/dark-premium.md +14 -0
- package/.agents/skills/hyperframes-creative/palettes/jewel-rich.md +14 -0
- package/.agents/skills/hyperframes-creative/palettes/monochrome.md +14 -0
- package/.agents/skills/hyperframes-creative/palettes/nature-earth.md +14 -0
- package/.agents/skills/hyperframes-creative/palettes/neon-electric.md +14 -0
- package/.agents/skills/hyperframes-creative/palettes/pastel-soft.md +14 -0
- package/.agents/skills/hyperframes-creative/palettes/warm-editorial.md +14 -0
- package/.agents/skills/hyperframes-creative/references/audio-reactive.md +76 -0
- package/.agents/skills/hyperframes-creative/references/beat-direction.md +164 -0
- package/.agents/skills/hyperframes-creative/references/composition-patterns.md +199 -0
- package/.agents/skills/hyperframes-creative/references/data-in-motion.md +19 -0
- package/.agents/skills/hyperframes-creative/references/design-adherence.md +19 -0
- package/.agents/skills/hyperframes-creative/references/design-picker.md +123 -0
- package/.agents/skills/hyperframes-creative/references/design-spec.md +55 -0
- package/.agents/skills/hyperframes-creative/references/house-style.md +73 -0
- package/.agents/skills/hyperframes-creative/references/motion-principles.md +150 -0
- package/.agents/skills/hyperframes-creative/references/narration.md +92 -0
- package/.agents/skills/hyperframes-creative/references/prompt-expansion.md +68 -0
- package/.agents/skills/hyperframes-creative/references/typography.md +218 -0
- package/.agents/skills/hyperframes-creative/references/video-composition.md +63 -0
- package/.agents/skills/hyperframes-creative/references/visual-styles.md +457 -0
- package/.agents/skills/hyperframes-creative/scripts/contrast-report.mjs +353 -0
- package/.agents/skills/hyperframes-creative/scripts/extract-audio-data.py +188 -0
- package/.agents/skills/hyperframes-creative/scripts/package-loader.mjs +288 -0
- package/.agents/skills/hyperframes-creative/scripts/package-loader.test.mjs +62 -0
- package/.agents/skills/hyperframes-creative/templates/design-picker.html +1432 -0
- package/.agents/skills/hyperframes-keyframes/SKILL.md +237 -0
- package/.agents/skills/hyperframes-keyframes/agents/openai.yaml +4 -0
- package/.agents/skills/hyperframes-keyframes/references/keyframe-patterns.md +106 -0
- package/.agents/skills/motion-graphics/SKILL.md +172 -0
- package/.agents/skills/motion-graphics/agents/builder.md +40 -0
- package/.agents/skills/motion-graphics/agents/director.md +53 -0
- package/.agents/skills/motion-graphics/agents/finalize.md +17 -0
- package/.agents/skills/motion-graphics/catalog-map.md +40 -0
- package/.agents/skills/motion-graphics/categories/asset-fusion/module.md +37 -0
- package/.agents/skills/motion-graphics/categories/charts/module.md +21 -0
- package/.agents/skills/motion-graphics/categories/kinetic-type/module.md +19 -0
- package/.agents/skills/motion-graphics/categories/logo-reveal/module.md +17 -0
- package/.agents/skills/motion-graphics/categories/lower-thirds/module.md +16 -0
- package/.agents/skills/motion-graphics/categories/maps/bake-basemap.mjs +273 -0
- package/.agents/skills/motion-graphics/categories/maps/module.md +61 -0
- package/.agents/skills/motion-graphics/categories/news/module.md +56 -0
- package/.agents/skills/motion-graphics/categories/stat/module.md +21 -0
- package/.agents/skills/motion-graphics/categories/tweet/module.md +16 -0
- package/.agents/skills/motion-graphics/categories/webpage/module.md +21 -0
- package/.agents/skills/motion-graphics/grounding/PROTOCOL.md +64 -0
- package/.agents/skills/motion-graphics/grounding/locate.mjs +227 -0
- package/.agents/skills/motion-graphics/phases/source/guide.md +21 -0
- package/.agents/skills/motion-graphics/references/builder-contract.md +38 -0
- package/.agents/skills/motion-graphics/references/motion-vocabulary.md +43 -0
- package/.agents/skills/motion-graphics/references/shot-plan-ir.md +54 -0
- package/.agents/skills/motion-graphics/samples/asset-fusion/_ref-circle-highlight.html +306 -0
- package/.agents/skills/product-launch-video/SKILL.md +208 -0
- package/.agents/skills/product-launch-video/references/cut-catalog.md +220 -0
- package/.agents/skills/product-launch-video/references/motion-language.md +156 -0
- package/.agents/skills/product-launch-video/references/story-design.md +373 -0
- package/.agents/skills/product-launch-video/references/visual-design.md +126 -0
- package/.agents/skills/product-launch-video/scripts/assemble-index.mjs +570 -0
- package/.agents/skills/product-launch-video/scripts/audio.mjs +260 -0
- package/.agents/skills/product-launch-video/scripts/build-frame.mjs +536 -0
- package/.agents/skills/product-launch-video/scripts/captions.mjs +508 -0
- package/.agents/skills/product-launch-video/scripts/lib/assets.mjs +55 -0
- package/.agents/skills/product-launch-video/scripts/lib/dimensions.mjs +45 -0
- package/.agents/skills/product-launch-video/scripts/lib/pad-frame-duration.mjs +36 -0
- package/.agents/skills/product-launch-video/scripts/lib/pad-frame-duration.test.mjs +76 -0
- package/.agents/skills/product-launch-video/scripts/lib/storyboard.mjs +249 -0
- package/.agents/skills/product-launch-video/scripts/lib/tokens.mjs +204 -0
- package/.agents/skills/product-launch-video/scripts/lib/transition-registry.mjs +38 -0
- package/.agents/skills/product-launch-video/scripts/lib/transitions.json +71 -0
- package/.agents/skills/product-launch-video/scripts/stage-assets.mjs +39 -0
- package/.agents/skills/product-launch-video/scripts/transitions.mjs +327 -0
- package/.agents/skills/product-launch-video/sub-agents/frame-worker.md +75 -0
- package/.agents/skills/slideshow/SKILL.md +550 -0
- package/.agents/skills/slideshow/references/standalone-harness.md +1020 -0
- package/.agents/skills/talking-head-recut/NOTICE.md +39 -0
- package/.agents/skills/talking-head-recut/SKILL.md +1195 -0
- package/.agents/skills/talking-head-recut/assets/vendor/gsap.min.js +10 -0
- package/.agents/skills/talking-head-recut/references/DESIGN_INDEX.md +145 -0
- package/.agents/skills/talking-head-recut/references/frames/clean.html +92 -0
- package/.agents/skills/talking-head-recut/references/frames/hairline.html +171 -0
- package/.agents/skills/talking-head-recut/references/frames/polaroid.html +131 -0
- package/.agents/skills/talking-head-recut/references/layouts/overlay.html +164 -0
- package/.agents/skills/talking-head-recut/references/layouts/pip.html +143 -0
- package/.agents/skills/talking-head-recut/references/layouts/split.html +121 -0
- package/.agents/skills/talking-head-recut/references/layouts/stack.html +109 -0
- package/.agents/skills/talking-head-recut/references/styles/academic.html +172 -0
- package/.agents/skills/talking-head-recut/references/styles/audit.html +170 -0
- package/.agents/skills/talking-head-recut/references/styles/editorial.html +189 -0
- package/.agents/skills/talking-head-recut/references/styles/geom.html +181 -0
- package/.agents/skills/talking-head-recut/references/styles/minimal.html +130 -0
- package/.agents/skills/talking-head-recut/references/styles/spotlight.html +142 -0
- package/.agents/skills/talking-head-recut/references/styles/swiss.html +188 -0
- package/.agents/skills/talking-head-recut/references/styles/terminal.html +196 -0
- package/.agents/skills/talking-head-recut/references/styles/whiteboard.html +170 -0
- package/.agents/skills/talking-head-recut/references/styles/xhs.html +206 -0
- package/.agents/skills/vidfarm-media/SKILL.md +85 -0
- package/.agents/skills/vidfarm-media/references/tts.md +54 -0
- package/.agents/skills/vidfarm-media/scripts/audio.mjs +628 -0
- package/.agents/skills/vidfarm-media/scripts/wait-bgm.mjs +31 -0
- package/.agents/skills/website-to-video/SKILL.md +145 -0
- package/.agents/skills/website-to-video/assets/sfx/CREDITS.md +35 -0
- package/.agents/skills/website-to-video/assets/sfx/manifest.json +97 -0
- package/.agents/skills/website-to-video/references/beat-builder-guide.md +263 -0
- package/.agents/skills/website-to-video/references/capabilities.md +713 -0
- package/.agents/skills/website-to-video/references/step-0-capture.md +55 -0
- package/.agents/skills/website-to-video/references/step-1-design.md +333 -0
- package/.agents/skills/website-to-video/references/step-2-brief.md +178 -0
- package/.agents/skills/website-to-video/references/step-3-storyboard.md +572 -0
- package/.agents/skills/website-to-video/references/step-4-vo.md +225 -0
- package/.agents/skills/website-to-video/references/step-5-build.md +483 -0
- package/.agents/skills/website-to-video/references/step-6-validate.md +341 -0
- package/.agents/skills/website-to-video/scripts/w2h-verify.mjs +759 -0
- package/SKILL.director.md +37 -0
- package/SKILL.platform.md +6 -1
- package/demo/dist/app.css +1 -1
- package/demo/dist/app.js +369 -85
- package/dist/src/app.js +630 -140
- package/dist/src/cli.js +529 -12
- package/dist/src/composition-runtime.js +262 -3
- package/dist/src/config.js +13 -0
- package/dist/src/devcli/doctor.js +192 -0
- package/dist/src/devcli/hyperframes-cli.js +118 -0
- package/dist/src/devcli/skills.js +476 -0
- package/dist/src/devcli/stills.js +249 -0
- package/dist/src/editor-chat.js +256 -0
- package/dist/src/frontend/homepage-client.js +50 -1
- package/dist/src/frontend/homepage-shared.js +197 -0
- package/dist/src/frontend/homepage-store.js +10 -1
- package/dist/src/frontend/homepage-view.js +43 -5
- package/dist/src/homepage.js +51 -18
- package/dist/src/hyperframes/composition.js +5 -5
- package/dist/src/services/composition-lint.js +199 -0
- package/dist/src/services/hyperframes.js +67 -13
- package/dist/src/services/serverless-records.js +9 -0
- package/package.json +2 -1
- package/public/assets/homepage-client-app.js +23 -23
|
@@ -0,0 +1,277 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reactive-displacement
|
|
3
|
+
description: Physical collision where an entering element's spring drives the exiting element's displacement — single source of truth makes the motion causally linked.
|
|
4
|
+
metadata:
|
|
5
|
+
tags: transition, physics, collision, displacement, spring, causal
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Reactive Displacement
|
|
9
|
+
|
|
10
|
+
Exit animation of element A is mathematically DERIVED from the entry spring of element B. Creates a causal link: "A moves _because_ B hit it." Distinct from [scale-swap-transition](scale-swap-transition.md) (which overlaps but isn't causal) and [card-morph-anchor](card-morph-anchor.md) (which uses one container morphing dimensions).
|
|
11
|
+
|
|
12
|
+
## How It Works
|
|
13
|
+
|
|
14
|
+
A single 0→1 driver tween (the "entry spring") feeds two derived motions:
|
|
15
|
+
|
|
16
|
+
- **Intruder** (B, entering): position interpolated from off-stage to settled
|
|
17
|
+
- **Victim** (A, exiting): position interpolated from settled to off-stage in the OPPOSITE direction, but completing at a fraction `VICTIM_FRACTION` of the driver (not 1.0)
|
|
18
|
+
|
|
19
|
+
The fact that the victim's exit finishes BEFORE the intruder's entry creates the "hit then settle" rhythm. Both motions share the same eased driver, so the impact moment is mathematically synchronized.
|
|
20
|
+
|
|
21
|
+
## HTML
|
|
22
|
+
|
|
23
|
+
```html
|
|
24
|
+
<div
|
|
25
|
+
class="scene"
|
|
26
|
+
id="collide-scene"
|
|
27
|
+
data-composition-id="collide-scene"
|
|
28
|
+
data-start="0"
|
|
29
|
+
data-duration="3"
|
|
30
|
+
data-track-index="0"
|
|
31
|
+
>
|
|
32
|
+
<div class="stage">
|
|
33
|
+
<div class="card victim" id="victim">
|
|
34
|
+
<div class="card-title">{victimHeadline}</div>
|
|
35
|
+
<div class="card-sub">{victimSubline}</div>
|
|
36
|
+
</div>
|
|
37
|
+
<div class="card intruder" id="intruder">
|
|
38
|
+
<div class="card-title">{intruderHeadline}</div>
|
|
39
|
+
<div class="card-sub">{intruderSubline}</div>
|
|
40
|
+
</div>
|
|
41
|
+
</div>
|
|
42
|
+
</div>
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## CSS
|
|
46
|
+
|
|
47
|
+
```css
|
|
48
|
+
.scene {
|
|
49
|
+
position: relative;
|
|
50
|
+
width: 100%;
|
|
51
|
+
height: 100%;
|
|
52
|
+
overflow: hidden;
|
|
53
|
+
background: radial-gradient(ellipse at center, {bgColor} 0%, {bgColorDeep} 70%);
|
|
54
|
+
font-family: {font};
|
|
55
|
+
}
|
|
56
|
+
.stage {
|
|
57
|
+
position: absolute;
|
|
58
|
+
inset: 0;
|
|
59
|
+
display: grid;
|
|
60
|
+
place-items: center;
|
|
61
|
+
}
|
|
62
|
+
.card {
|
|
63
|
+
position: absolute;
|
|
64
|
+
/* both at center; transform translates them */
|
|
65
|
+
display: flex;
|
|
66
|
+
flex-direction: column;
|
|
67
|
+
align-items: center;
|
|
68
|
+
justify-content: center;
|
|
69
|
+
gap: 24px;
|
|
70
|
+
padding: 64px 80px;
|
|
71
|
+
border-radius: 28px;
|
|
72
|
+
will-change: transform, opacity;
|
|
73
|
+
}
|
|
74
|
+
.victim {
|
|
75
|
+
background: linear-gradient(160deg, {victimTint} 0%, {bgColorDeep} 70%);
|
|
76
|
+
border: 1px solid {victimTint};
|
|
77
|
+
z-index: 1;
|
|
78
|
+
}
|
|
79
|
+
.intruder {
|
|
80
|
+
background: linear-gradient(160deg, {intruderTint} 0%, {bgColorDeep} 70%);
|
|
81
|
+
border: 2px solid {intruderBorder};
|
|
82
|
+
box-shadow: 0 28px 96px {intruderTint};
|
|
83
|
+
z-index: 2;
|
|
84
|
+
}
|
|
85
|
+
.card-title {
|
|
86
|
+
font-size: 200px;
|
|
87
|
+
font-weight: 900;
|
|
88
|
+
color: {textColor};
|
|
89
|
+
line-height: 1;
|
|
90
|
+
letter-spacing: -4px;
|
|
91
|
+
}
|
|
92
|
+
.card-sub {
|
|
93
|
+
font-size: 36px;
|
|
94
|
+
font-weight: 800;
|
|
95
|
+
letter-spacing: 10px;
|
|
96
|
+
text-transform: uppercase;
|
|
97
|
+
color: {accentColor};
|
|
98
|
+
text-align: center;
|
|
99
|
+
}
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
## GSAP Timeline
|
|
103
|
+
|
|
104
|
+
```html
|
|
105
|
+
<script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
|
|
106
|
+
<script>
|
|
107
|
+
window.__timelines = window.__timelines || {};
|
|
108
|
+
const tl = gsap.timeline({ paused: true });
|
|
109
|
+
|
|
110
|
+
// Off-stage distances are derived from the stage width.
|
|
111
|
+
const INTRUDER_START_X = STAGE_W; // off-stage right
|
|
112
|
+
const VICTIM_END_X = -STAGE_W; // off-stage left, opposite direction
|
|
113
|
+
|
|
114
|
+
// Initial state — victim centered, intruder off-stage right
|
|
115
|
+
gsap.set("#victim", { x: 0, opacity: 1, rotation: 0 });
|
|
116
|
+
gsap.set("#intruder", { x: INTRUDER_START_X, opacity: 0, rotation: -INTRUDER_TILT });
|
|
117
|
+
|
|
118
|
+
// Single driver — the entry spring — runs 0→1 over the impact arc
|
|
119
|
+
const driver = { p: 0 };
|
|
120
|
+
tl.to(
|
|
121
|
+
driver,
|
|
122
|
+
{
|
|
123
|
+
p: 1,
|
|
124
|
+
duration: DRIVER_DUR,
|
|
125
|
+
ease: `back.out(${BOUNCE_FACTOR})`, // intruder spring
|
|
126
|
+
onUpdate: () => {
|
|
127
|
+
// Intruder: full 0→1 progress maps to enter (off-stage → center)
|
|
128
|
+
const intruderX = INTRUDER_START_X * (1 - driver.p);
|
|
129
|
+
const intruderOpacity = Math.min(1, driver.p * FADE_IN_SHARPNESS);
|
|
130
|
+
const intruderRot = -INTRUDER_TILT * (1 - driver.p); // settle to 0°
|
|
131
|
+
const intruder = document.getElementById("intruder");
|
|
132
|
+
intruder.style.transform = `translate(-50%, -50%) translateX(${intruderX}px) rotate(${intruderRot}deg)`;
|
|
133
|
+
intruder.style.opacity = String(intruderOpacity);
|
|
134
|
+
|
|
135
|
+
// Victim: completes exit at VICTIM_FRACTION of driver (intruder still flying in)
|
|
136
|
+
// so the impact MOMENT is the visual punch — by the time intruder centers,
|
|
137
|
+
// victim is already off-stage.
|
|
138
|
+
const victimP = Math.min(1, driver.p / VICTIM_FRACTION);
|
|
139
|
+
const victimX = VICTIM_END_X * victimP;
|
|
140
|
+
const victimOpacity = 1 - victimP;
|
|
141
|
+
const victim = document.getElementById("victim");
|
|
142
|
+
victim.style.transform = `translate(-50%, -50%) translateX(${victimX}px)`;
|
|
143
|
+
victim.style.opacity = String(victimOpacity);
|
|
144
|
+
},
|
|
145
|
+
},
|
|
146
|
+
DRIVER_AT,
|
|
147
|
+
);
|
|
148
|
+
|
|
149
|
+
// Climax dwell — intruder holds at center after settle (no additional motion;
|
|
150
|
+
// composition continues with intruder centered for ≥ DWELL_MIN seconds).
|
|
151
|
+
|
|
152
|
+
window.__timelines["collide-scene"] = tl;
|
|
153
|
+
</script>
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
## How to Choose Values
|
|
157
|
+
|
|
158
|
+
- **DRIVER_AT** — when the entry spring begins
|
|
159
|
+
- Range: phase-dependent (typically a few seconds in)
|
|
160
|
+
- Effects: too early skips setup beats; too late stalls the cut
|
|
161
|
+
- Constraints: must allow ≥ DWELL_MIN of climax dwell before composition ends
|
|
162
|
+
- Reference: example schedules the displacement after the prior reading beat resolves
|
|
163
|
+
|
|
164
|
+
- **DRIVER_DUR** — full intruder entry duration
|
|
165
|
+
- Range: 0.6-1.4 s
|
|
166
|
+
- Effects: short = zippy/punchy impact; long = heavy/landed impact
|
|
167
|
+
- Constraints: tune against `BOUNCE_FACTOR` — higher bounce on long durations reads as floaty
|
|
168
|
+
- Reference: see the corresponding blueprint / example
|
|
169
|
+
|
|
170
|
+
- **BOUNCE_FACTOR** — `back.out()` coefficient on the intruder spring
|
|
171
|
+
- Range: 1.2-2.0 (discrete choice within `back.out` family)
|
|
172
|
+
- Effects: low ≈ firm settle; high ≈ overshoot/bounce
|
|
173
|
+
- Constraints: ease family stays `back.out` (or upgrade to `elastic.out` if you want oscillation); changing family rewrites the feel
|
|
174
|
+
- Reference: examples typically sit between 1.4 and 1.6
|
|
175
|
+
|
|
176
|
+
- **VICTIM_FRACTION** — fraction of `DRIVER_DUR` over which the victim completes its exit
|
|
177
|
+
- Range: 0.4-0.5
|
|
178
|
+
- Effects: < 0.4 victim disappears before impact reads; > 0.5 motion feels parallel, not causal
|
|
179
|
+
- Constraints: hard upper limit ~0.6; beyond that the collision metaphor breaks
|
|
180
|
+
- Reference: this rule's pattern uses ~0.5
|
|
181
|
+
|
|
182
|
+
- **STAGE_W** — stage width in pixels, used to place elements off-stage
|
|
183
|
+
- Range: equal to the composition's `data-width`
|
|
184
|
+
- Effects: smaller values leave the off-stage element partially visible at start
|
|
185
|
+
- Constraints: must be ≥ composition width
|
|
186
|
+
- Reference: examples use the project's render width directly
|
|
187
|
+
|
|
188
|
+
- **INTRUDER_TILT** — initial rotation (degrees) the intruder rotates from as it settles to 0°
|
|
189
|
+
- Range: 5-15°
|
|
190
|
+
- Effects: low = clean glide; high = visible "spin-and-plant"
|
|
191
|
+
- Constraints: keep sign consistent with entry direction (matches momentum transfer)
|
|
192
|
+
- Reference: ~10° is a typical mid-impact tilt
|
|
193
|
+
|
|
194
|
+
- **FADE_IN_SHARPNESS** — multiplier controlling how quickly intruder opacity reaches 1
|
|
195
|
+
- Range: 3-8 (intruder reaches opacity 1 at `1/FADE_IN_SHARPNESS` of progress)
|
|
196
|
+
- Effects: low = soft fade alongside motion; high = pops in early and reads as solid
|
|
197
|
+
- Constraints: > 1; below 1 means intruder is still transparent at center
|
|
198
|
+
- Reference: most examples use a sharp early reveal
|
|
199
|
+
|
|
200
|
+
- **DWELL_MIN** — minimum climax dwell after the intruder settles
|
|
201
|
+
- Range: ≥ 1.0 s
|
|
202
|
+
- Effects: shorter feels rushed and unreadable; longer stalls the comp
|
|
203
|
+
- Constraints: post-impact dwell is where the new content gets read — do not skip
|
|
204
|
+
- Reference: 1.0-1.5 s is typical
|
|
205
|
+
|
|
206
|
+
## Variations
|
|
207
|
+
|
|
208
|
+
### Impact rotation on victim
|
|
209
|
+
|
|
210
|
+
The victim doesn't just slide off — it ALSO rotates from the impact angle:
|
|
211
|
+
|
|
212
|
+
```js
|
|
213
|
+
const victimRot = victimP * -VICTIM_KICK_DEG; // rotates as it slides
|
|
214
|
+
victim.style.transform = `translate(-50%, -50%) translateX(${victimX}px) rotate(${victimRot}deg)`;
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
`VICTIM_KICK_DEG` is typically 15-25°; pick magnitude to match the perceived intruder weight.
|
|
218
|
+
|
|
219
|
+
### Vertical collision
|
|
220
|
+
|
|
221
|
+
Intruder enters from top, victim displaced downward. Same math with Y instead of X. Visual feels like "weight dropped on it."
|
|
222
|
+
|
|
223
|
+
### Wobble after settle
|
|
224
|
+
|
|
225
|
+
After the intruder centers, a damped sine wobble (`±WOBBLE_AMP_DEG` rotation, decaying over `WOBBLE_DUR`) before stillness. Adds "impact aftermath" before climax dwell.
|
|
226
|
+
|
|
227
|
+
```js
|
|
228
|
+
const wobble = { p: 0 };
|
|
229
|
+
tl.to(
|
|
230
|
+
wobble,
|
|
231
|
+
{
|
|
232
|
+
p: Math.PI * WOBBLE_CYCLES * 2,
|
|
233
|
+
duration: WOBBLE_DUR,
|
|
234
|
+
ease: "none",
|
|
235
|
+
onUpdate: () => {
|
|
236
|
+
const rot =
|
|
237
|
+
Math.sin(wobble.p) * WOBBLE_AMP_DEG * (1 - wobble.p / (Math.PI * WOBBLE_CYCLES * 2)); // linear decay
|
|
238
|
+
intruder.style.transform = `translate(-50%, -50%) rotate(${rot}deg)`;
|
|
239
|
+
},
|
|
240
|
+
},
|
|
241
|
+
DRIVER_AT + DRIVER_DUR,
|
|
242
|
+
);
|
|
243
|
+
```
|
|
244
|
+
|
|
245
|
+
### Multi-victim ripple
|
|
246
|
+
|
|
247
|
+
Intruder displaces multiple aligned cards, each victim getting a slightly delayed exit (cascade ripple). Each victim's `victimP` uses a different driver phase offset.
|
|
248
|
+
|
|
249
|
+
## Key Principles
|
|
250
|
+
|
|
251
|
+
- **Single driver = single source of truth** — the entry spring drives BOTH motions. Independent tweens for intruder and victim destroy the causal link; they'd just happen to be near each other in time, not collided.
|
|
252
|
+
- **Victim completes at a fraction of driver** — by the time the intruder reaches center, the victim is GONE. The "hit" is the moment they overlap; after that the victim is just exiting space the intruder will fill.
|
|
253
|
+
- **Directional momentum transfer** — intruder from positive X → victim moves negative X. Same axis. If they move on different axes, it looks like they passed each other, not collided.
|
|
254
|
+
- **Intruder z-index ABOVE victim** — during overlap, the intruder should appear in FRONT (it's the "winner" of the collision). Otherwise the victim looks like it tunneled through.
|
|
255
|
+
- **Intruder enters with rotation, settles flat** — adds momentum visualization. A small initial tilt → 0° at settle reads as "spinning in then planting."
|
|
256
|
+
- **Climax dwell after impact** — the impact is the headline beat. Post-impact dwell is where the new content gets read.
|
|
257
|
+
|
|
258
|
+
## Critical Constraints
|
|
259
|
+
|
|
260
|
+
- **Timeline must be paused**: `gsap.timeline({ paused: true })`
|
|
261
|
+
- **Registry key = `data-composition-id`**
|
|
262
|
+
- **Single driver, multiple derived values in same onUpdate** — don't tween intruder and victim with separate `tl.to()` calls; use ONE driver and compute both inside its onUpdate
|
|
263
|
+
- **`overflow: hidden` on `.scene`** — off-stage motion exceeds the frame
|
|
264
|
+
- **`will-change: transform, opacity`** on both cards
|
|
265
|
+
- **Intruder z-index > victim z-index** — explicit, not relying on DOM order alone
|
|
266
|
+
|
|
267
|
+
## Combinations
|
|
268
|
+
|
|
269
|
+
- [hacker-flip-3d.md](hacker-flip-3d.md) — intruder text reveals via hacker-flip during the entry phase
|
|
270
|
+
- [sine-wave-loop.md](sine-wave-loop.md) — idle breathing on intruder during climax dwell
|
|
271
|
+
- [vertical-spring-ticker.md](vertical-spring-ticker.md) — intruder is a ticker that "shoves" the previous content out
|
|
272
|
+
|
|
273
|
+
## Pairs with HF skills
|
|
274
|
+
|
|
275
|
+
- `/hyperframes-animation` — single driver, multi-value onUpdate
|
|
276
|
+
- `/hyperframes-core` — composition wiring
|
|
277
|
+
- `/hyperframes-cli` — `hyperframes lint`
|
|
@@ -0,0 +1,298 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: scale-swap-transition
|
|
3
|
+
description: Coordinated shrink-out + spring pop-in morph-like transition between two elements — no SVG path interpolation needed.
|
|
4
|
+
metadata:
|
|
5
|
+
tags: transition, morph, scale, swap, spring, pop
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Scale-Swap Transition
|
|
9
|
+
|
|
10
|
+
Simulates a "morph" between two DOM elements by overlapping exit and entrance scale animations. Lighter weight than [card-morph-anchor](card-morph-anchor.md) (which morphs container dimensions) and easier than SVG path interpolation.
|
|
11
|
+
|
|
12
|
+
## How It Works
|
|
13
|
+
|
|
14
|
+
At a single trigger time, two coordinated tweens fire:
|
|
15
|
+
|
|
16
|
+
1. **Outgoing element**: scale `1.0 → EXIT_SCALE` + opacity `1 → 0` (fast `power2.in`)
|
|
17
|
+
2. **Incoming element**: scale `EXIT_SCALE → 1.0` + opacity `0 → 1` (bouncy `back.out(${BOUNCE_FACTOR})` with overshoot)
|
|
18
|
+
|
|
19
|
+
A small `OVERLAP` window during which both are mid-tween creates the "morph" illusion. Incoming sits on top via z-index so the outgoing's fade-tail doesn't bleed through.
|
|
20
|
+
|
|
21
|
+
## HTML
|
|
22
|
+
|
|
23
|
+
```html
|
|
24
|
+
<div
|
|
25
|
+
class="scene"
|
|
26
|
+
id="swap-scene"
|
|
27
|
+
data-composition-id="swap-scene"
|
|
28
|
+
data-start="0"
|
|
29
|
+
data-duration="3"
|
|
30
|
+
data-track-index="0"
|
|
31
|
+
>
|
|
32
|
+
<div class="stack">
|
|
33
|
+
<div class="swap-wrap">
|
|
34
|
+
<div class="card outgoing" id="outgoing">
|
|
35
|
+
<div class="icon">{outgoingIcon}</div>
|
|
36
|
+
<div class="title">{outgoingLabel}</div>
|
|
37
|
+
</div>
|
|
38
|
+
<div class="card incoming" id="incoming">
|
|
39
|
+
<div class="icon">{incomingIcon}</div>
|
|
40
|
+
<div class="title">{incomingLabel}</div>
|
|
41
|
+
<div class="sub" id="sub">{incomingSubline}</div>
|
|
42
|
+
</div>
|
|
43
|
+
</div>
|
|
44
|
+
<div class="brand">{Brand}</div>
|
|
45
|
+
</div>
|
|
46
|
+
</div>
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## CSS
|
|
50
|
+
|
|
51
|
+
```css
|
|
52
|
+
.scene {
|
|
53
|
+
position: relative;
|
|
54
|
+
width: 100%;
|
|
55
|
+
height: 100%;
|
|
56
|
+
display: grid;
|
|
57
|
+
place-items: center;
|
|
58
|
+
background: {sceneBg};
|
|
59
|
+
font-family: {font};
|
|
60
|
+
}
|
|
61
|
+
.stack {
|
|
62
|
+
display: flex;
|
|
63
|
+
flex-direction: column;
|
|
64
|
+
align-items: center;
|
|
65
|
+
gap: STACK_GAP;
|
|
66
|
+
}
|
|
67
|
+
.swap-wrap {
|
|
68
|
+
position: relative;
|
|
69
|
+
width: SWAP_WRAP_W;
|
|
70
|
+
height: SWAP_WRAP_H;
|
|
71
|
+
}
|
|
72
|
+
.card {
|
|
73
|
+
position: absolute;
|
|
74
|
+
inset: 0;
|
|
75
|
+
display: flex;
|
|
76
|
+
flex-direction: column;
|
|
77
|
+
align-items: center;
|
|
78
|
+
justify-content: center;
|
|
79
|
+
gap: CARD_INNER_GAP;
|
|
80
|
+
border-radius: CARD_RADIUS;
|
|
81
|
+
padding: CARD_PADDING;
|
|
82
|
+
/* Both elements share transform-origin so they "morph" around the same anchor */
|
|
83
|
+
transform-origin: 50% 50%;
|
|
84
|
+
will-change: transform, opacity;
|
|
85
|
+
}
|
|
86
|
+
.card .icon {
|
|
87
|
+
font-size: ICON_SIZE;
|
|
88
|
+
}
|
|
89
|
+
.card .title {
|
|
90
|
+
font-size: TITLE_SIZE;
|
|
91
|
+
font-weight: 900;
|
|
92
|
+
letter-spacing: TITLE_TRACKING;
|
|
93
|
+
text-transform: uppercase;
|
|
94
|
+
}
|
|
95
|
+
.card .sub {
|
|
96
|
+
font-size: SUB_SIZE;
|
|
97
|
+
font-weight: 700;
|
|
98
|
+
color: {accentColor};
|
|
99
|
+
opacity: 0;
|
|
100
|
+
}
|
|
101
|
+
.outgoing {
|
|
102
|
+
z-index: 1;
|
|
103
|
+
background: {outgoingBg};
|
|
104
|
+
border: 1px solid {outgoingBorder};
|
|
105
|
+
color: {textColor};
|
|
106
|
+
}
|
|
107
|
+
.incoming {
|
|
108
|
+
/* Incoming starts hidden + smaller, will pop in */
|
|
109
|
+
z-index: 2;
|
|
110
|
+
background: {incomingBg};
|
|
111
|
+
border: 1px solid {incomingBorder};
|
|
112
|
+
color: {textColor};
|
|
113
|
+
opacity: 0;
|
|
114
|
+
transform: scale(EXIT_SCALE);
|
|
115
|
+
}
|
|
116
|
+
.brand {
|
|
117
|
+
font-size: BRAND_SIZE;
|
|
118
|
+
font-weight: 900;
|
|
119
|
+
letter-spacing: BRAND_TRACKING;
|
|
120
|
+
text-transform: uppercase;
|
|
121
|
+
color: {brandColor};
|
|
122
|
+
}
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
## GSAP Timeline
|
|
126
|
+
|
|
127
|
+
```html
|
|
128
|
+
<script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
|
|
129
|
+
<script>
|
|
130
|
+
window.__timelines = window.__timelines || {};
|
|
131
|
+
const tl = gsap.timeline({ paused: true });
|
|
132
|
+
|
|
133
|
+
// Outgoing: shrink + fade fast
|
|
134
|
+
tl.to(
|
|
135
|
+
"#outgoing",
|
|
136
|
+
{
|
|
137
|
+
scale: EXIT_SCALE,
|
|
138
|
+
opacity: 0,
|
|
139
|
+
duration: EXIT_DUR,
|
|
140
|
+
ease: "power2.in",
|
|
141
|
+
},
|
|
142
|
+
TRIGGER,
|
|
143
|
+
);
|
|
144
|
+
|
|
145
|
+
// Incoming: scale up + fade in with overshoot, starts slightly BEFORE outgoing
|
|
146
|
+
// finishes (OVERLAP creates the morph illusion).
|
|
147
|
+
tl.to(
|
|
148
|
+
"#incoming",
|
|
149
|
+
{
|
|
150
|
+
scale: 1.0,
|
|
151
|
+
opacity: 1,
|
|
152
|
+
duration: ENTER_DUR,
|
|
153
|
+
ease: `back.out(${BOUNCE_FACTOR})`,
|
|
154
|
+
},
|
|
155
|
+
TRIGGER + EXIT_DUR - OVERLAP,
|
|
156
|
+
);
|
|
157
|
+
|
|
158
|
+
// Subline reveals AFTER the incoming card settles
|
|
159
|
+
tl.fromTo(
|
|
160
|
+
"#sub",
|
|
161
|
+
{ opacity: 0, y: SUB_REVEAL_Y_PX },
|
|
162
|
+
{ opacity: 1, y: 0, duration: SUB_REVEAL_DUR, ease: "power3.out" },
|
|
163
|
+
TRIGGER + EXIT_DUR + SUB_REVEAL_DELAY,
|
|
164
|
+
);
|
|
165
|
+
|
|
166
|
+
// Brand fades in early for context
|
|
167
|
+
tl.from(
|
|
168
|
+
".brand",
|
|
169
|
+
{ opacity: 0, y: BRAND_REVEAL_Y_PX, duration: BRAND_REVEAL_DUR, ease: "power3.out" },
|
|
170
|
+
BRAND_REVEAL_AT,
|
|
171
|
+
);
|
|
172
|
+
|
|
173
|
+
window.__timelines["swap-scene"] = tl;
|
|
174
|
+
</script>
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
## Variations
|
|
178
|
+
|
|
179
|
+
### Delayed inner content reveal
|
|
180
|
+
|
|
181
|
+
The classic pattern: morph the container, then reveal inner text once the container has settled (as in the example above with `.sub`). The 0.2-0.4s gap between morph end and content reveal lets the viewer's eye land on the new container shape before reading the content.
|
|
182
|
+
|
|
183
|
+
### Triple swap (3-state cycle)
|
|
184
|
+
|
|
185
|
+
Chain: A→B→C with two triggers `TRIGGER_AB` and `TRIGGER_BC`. Each transition needs its own pair of tweens, and the previous incoming becomes the next outgoing. Useful for state evolution narratives (e.g. early-state → mid-state → final-state labels).
|
|
186
|
+
|
|
187
|
+
```js
|
|
188
|
+
tl.to("#stateA", { scale: EXIT_SCALE, opacity: 0, duration: EXIT_DUR }, TRIGGER_AB);
|
|
189
|
+
tl.to(
|
|
190
|
+
"#stateB",
|
|
191
|
+
{ scale: 1.0, opacity: 1, duration: ENTER_DUR, ease: `back.out(${BOUNCE_FACTOR})` },
|
|
192
|
+
TRIGGER_AB + EXIT_DUR - OVERLAP,
|
|
193
|
+
);
|
|
194
|
+
tl.to("#stateB", { scale: EXIT_SCALE, opacity: 0, duration: EXIT_DUR }, TRIGGER_BC);
|
|
195
|
+
tl.to(
|
|
196
|
+
"#stateC",
|
|
197
|
+
{ scale: 1.0, opacity: 1, duration: ENTER_DUR, ease: `back.out(${BOUNCE_FACTOR})` },
|
|
198
|
+
TRIGGER_BC + EXIT_DUR - OVERLAP,
|
|
199
|
+
);
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
### Color-shift transition (no scale)
|
|
203
|
+
|
|
204
|
+
For a flat morph between two same-shape states, drop the scale and keep only opacity + a brief background hue tween. Less dramatic but matches a more product-UI tone.
|
|
205
|
+
|
|
206
|
+
## How to Choose Values
|
|
207
|
+
|
|
208
|
+
### Timing (seconds)
|
|
209
|
+
|
|
210
|
+
- **TRIGGER** — when the swap fires.
|
|
211
|
+
- Constraints: must be ≥ the outgoing element's settled time + a presence-dwell so the outgoing "lands" before transforming
|
|
212
|
+
- **EXIT_DUR** — outgoing shrink + fade duration.
|
|
213
|
+
- Range: 0.3-0.5 s
|
|
214
|
+
- **ENTER_DUR** — incoming pop-in duration.
|
|
215
|
+
- Range: 0.45-0.7 s (longer than `EXIT_DUR` to let the overshoot settle)
|
|
216
|
+
- **OVERLAP** — how much the entrance starts before the exit finishes.
|
|
217
|
+
- Range: 0.1-0.2 s
|
|
218
|
+
- Constraints: too much (>0.3 s) makes both clearly visible together (no morph); too little (<0.05 s) leaves a visible empty gap
|
|
219
|
+
- **SUB_REVEAL_DELAY** — gap between incoming settle and subline reveal.
|
|
220
|
+
- Range: 0.2-0.4 s; reveals during the morph compete with the swap for attention
|
|
221
|
+
- **SUB_REVEAL_DUR** — subline fade-in.
|
|
222
|
+
- Range: 0.3-0.5 s
|
|
223
|
+
- **BRAND_REVEAL_AT** — when the brand/context line fades in.
|
|
224
|
+
- Constraints: must be < `TRIGGER` (brand is context for the swap, not synchronous with it)
|
|
225
|
+
- **BRAND_REVEAL_DUR** — brand fade-in duration.
|
|
226
|
+
- Range: 0.4-0.8 s
|
|
227
|
+
|
|
228
|
+
### Physics
|
|
229
|
+
|
|
230
|
+
- **EXIT_SCALE** — target scale for outgoing (and starting scale for incoming).
|
|
231
|
+
- Range: 0.6-0.8; smaller exits feel more dramatic but risk reading as "vanish" instead of "morph"
|
|
232
|
+
- **BOUNCE_FACTOR** — `back.out(${BOUNCE_FACTOR})` overshoot on the incoming.
|
|
233
|
+
- Range: 1.4 (soft) - 1.8 (firm) - 2.2 (cartoony)
|
|
234
|
+
|
|
235
|
+
### Positioning offsets
|
|
236
|
+
|
|
237
|
+
- **SUB_REVEAL_Y_PX** — subline initial y offset (positive = below resting).
|
|
238
|
+
- Range: 8-20 px
|
|
239
|
+
- **BRAND_REVEAL_Y_PX** — brand initial y offset.
|
|
240
|
+
- Range: 10-24 px
|
|
241
|
+
|
|
242
|
+
### Layout
|
|
243
|
+
|
|
244
|
+
- **STACK_GAP** — gap between swap container and brand line.
|
|
245
|
+
- Range: 40-96 px
|
|
246
|
+
- **SWAP_WRAP_W / SWAP_WRAP_H** — fixed swap container dimensions; both cards `inset: 0` inside.
|
|
247
|
+
- Constraints: pick dimensions that fit both states' content; the wrap does not resize during the swap
|
|
248
|
+
- **CARD_INNER_GAP** — gap between icon and title inside a card.
|
|
249
|
+
- Range: 16-32 px
|
|
250
|
+
- **CARD_RADIUS / CARD_PADDING** — card corner radius and inner padding.
|
|
251
|
+
- Range: radius 24-40 px; padding 32-64 px
|
|
252
|
+
- **ICON_SIZE / TITLE_SIZE / SUB_SIZE / BRAND_SIZE** — typographic sizes.
|
|
253
|
+
- Constraints: titles dominate (~80-120 px at 1080p); sub and brand are accent-sized
|
|
254
|
+
- **TITLE_TRACKING / BRAND_TRACKING** — letter-spacing on uppercase labels.
|
|
255
|
+
- Range: 4-16 px (uppercase reads better with positive tracking)
|
|
256
|
+
|
|
257
|
+
### Tokens
|
|
258
|
+
|
|
259
|
+
- **{sceneBg}** — background gradient/color
|
|
260
|
+
- **{font}** — typographic stack
|
|
261
|
+
- **{textColor}** / **{accentColor}** / **{brandColor}** — semantic color tokens
|
|
262
|
+
- **{outgoingBg}** / **{outgoingBorder}** — outgoing card surface + border (typically warm or pre-action hue)
|
|
263
|
+
- **{incomingBg}** / **{incomingBorder}** — incoming card surface + border (typically cool or post-action hue)
|
|
264
|
+
- **{outgoingIcon}** / **{incomingIcon}** — single glyph/emoji per state
|
|
265
|
+
- **{outgoingLabel}** / **{incomingLabel}** — state labels
|
|
266
|
+
- **{incomingSubline}** — supporting copy that fades in after the incoming settles
|
|
267
|
+
- **{Brand}** — brand line shown beneath the swap
|
|
268
|
+
|
|
269
|
+
## Key Principles
|
|
270
|
+
|
|
271
|
+
- **Incoming z-index ABOVE outgoing** — without this, the outgoing's fade-tail (opacity 0.3-0.5) bleeds through the incoming's lower opacity and creates a "double-exposed" muddy frame
|
|
272
|
+
- **Both elements share `transform-origin: 50% 50%`** — different origins make the morph feel like one thing teleporting somewhere else
|
|
273
|
+
- **`OVERLAP` in the 0.1-0.2 s window** — too much overlap and both are clearly visible together (no morph); too little and there's a visible empty gap
|
|
274
|
+
- **Bouncy ease ONLY for the incoming** — outgoing uses `power2.in` (rushing away), incoming uses `back.out(${BOUNCE_FACTOR})` (arriving with weight). Reverse it and the swap feels mechanical
|
|
275
|
+
- **Inner content reveals AFTER container settles** — see `SUB_REVEAL_DELAY`. Reveals during the morph compete for attention and lose
|
|
276
|
+
- **Climax dwell ≥1 s after final state lands** — see SKILL universal constraints. After incoming + subline both settle, hold for ≥1 s
|
|
277
|
+
- **Brand reveal early, not at the swap** — context (brand, eyebrow) sets the stage; the swap is the headline. If brand reveals AT the swap, it competes
|
|
278
|
+
|
|
279
|
+
## Critical Constraints
|
|
280
|
+
|
|
281
|
+
- **Timeline must be paused**: `gsap.timeline({ paused: true })`
|
|
282
|
+
- **Registry key = `data-composition-id`**
|
|
283
|
+
- **No CSS `transition`** on either swap element — competes with GSAP
|
|
284
|
+
- **`will-change: transform, opacity`** on both swap elements
|
|
285
|
+
- **Both elements use `position: absolute; inset: 0`** in the same wrapper — they occupy the same footprint, swap fades one out and pops one in
|
|
286
|
+
- **Don't `display: none` the outgoing** after fade — leave it at `opacity: 0` so layout doesn't reflow
|
|
287
|
+
|
|
288
|
+
## Combinations
|
|
289
|
+
|
|
290
|
+
- [press-release-spring.md](press-release-spring.md) — button press TRIGGERS the swap (cause and effect)
|
|
291
|
+
- [sine-wave-loop.md](sine-wave-loop.md) — idle breathing on the final state
|
|
292
|
+
- [card-morph-anchor.md](card-morph-anchor.md) — alternative for SHAPE-changing transitions (this rule is for SAME-shape state swaps)
|
|
293
|
+
|
|
294
|
+
## Pairs with HF skills
|
|
295
|
+
|
|
296
|
+
- `/hyperframes-animation` — two coordinated tweens with overlap
|
|
297
|
+
- `/hyperframes-core` — composition wiring
|
|
298
|
+
- `/hyperframes-cli` — `hyperframes lint`
|