@mevdragon/vidfarm-devcli 0.14.0 → 0.15.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.
Files changed (418) hide show
  1. package/.agents/skills/embedded-captions/CATALOG.md +93 -0
  2. package/.agents/skills/embedded-captions/SKILL.md +286 -0
  3. package/.agents/skills/embedded-captions/assets/brand/CDPR-fankit-terms.txt +35 -0
  4. package/.agents/skills/embedded-captions/assets/brand/cyberpunk-widths.json +115 -0
  5. package/.agents/skills/embedded-captions/assets/fonts/char-widths.json +2211 -0
  6. package/.agents/skills/embedded-captions/assets/strokefonts/HersheyScript1.svg +242 -0
  7. package/.agents/skills/embedded-captions/assets/strokefonts/HersheyScriptMed.svg +242 -0
  8. package/.agents/skills/embedded-captions/dna/README.md +148 -0
  9. package/.agents/skills/embedded-captions/dna/chrome.json +68 -0
  10. package/.agents/skills/embedded-captions/dna/cream.json +69 -0
  11. package/.agents/skills/embedded-captions/dna/documentary.json +62 -0
  12. package/.agents/skills/embedded-captions/dna/editorial.json +70 -0
  13. package/.agents/skills/embedded-captions/dna/glitch.json +82 -0
  14. package/.agents/skills/embedded-captions/dna/ink.json +65 -0
  15. package/.agents/skills/embedded-captions/dna/keynote.json +62 -0
  16. package/.agents/skills/embedded-captions/dna/loud.json +75 -0
  17. package/.agents/skills/embedded-captions/dna/neon.json +58 -0
  18. package/.agents/skills/embedded-captions/dna/velocity.json +89 -0
  19. package/.agents/skills/embedded-captions/modes/cinematic/README.md +48 -0
  20. package/.agents/skills/embedded-captions/modes/cinematic/_archive/champion/spec.md +98 -0
  21. package/.agents/skills/embedded-captions/modes/cinematic/_archive/champion/template.html +188 -0
  22. package/.agents/skills/embedded-captions/modes/cinematic/_archive/memory-wall/spec.md +134 -0
  23. package/.agents/skills/embedded-captions/modes/cinematic/_archive/memory-wall/template.html +179 -0
  24. package/.agents/skills/embedded-captions/modes/cinematic/_archive/portrait-header/spec.md +81 -0
  25. package/.agents/skills/embedded-captions/modes/cinematic/_archive/portrait-header/template.html +170 -0
  26. package/.agents/skills/embedded-captions/modes/cinematic/cinematic-cream/spec.md +16 -0
  27. package/.agents/skills/embedded-captions/modes/cinematic/cinematic-cream/template.html +226 -0
  28. package/.agents/skills/embedded-captions/modes/cinematic/engine.html +355 -0
  29. package/.agents/skills/embedded-captions/modes/standard/_anatomy.md +233 -0
  30. package/.agents/skills/embedded-captions/modes/standard/_motion.md +192 -0
  31. package/.agents/skills/embedded-captions/modes/standard/fonts/build-fonts-css.cjs +97 -0
  32. package/.agents/skills/embedded-captions/references/aesthetic-principles.md +168 -0
  33. package/.agents/skills/embedded-captions/references/anti-patterns.md +188 -0
  34. package/.agents/skills/embedded-captions/references/bespoke-vs-presets.md +178 -0
  35. package/.agents/skills/embedded-captions/references/caption-grouping.md +130 -0
  36. package/.agents/skills/embedded-captions/references/composition-craft.md +522 -0
  37. package/.agents/skills/embedded-captions/references/direction-catalog.md +138 -0
  38. package/.agents/skills/embedded-captions/references/example-renders/champion.html +371 -0
  39. package/.agents/skills/embedded-captions/references/example-renders/memory-wall.html +334 -0
  40. package/.agents/skills/embedded-captions/references/failure-modes.md +145 -0
  41. package/.agents/skills/embedded-captions/references/layout-heuristics.md +238 -0
  42. package/.agents/skills/embedded-captions/references/motion-vocabulary.md +148 -0
  43. package/.agents/skills/embedded-captions/references/rail.md +68 -0
  44. package/.agents/skills/embedded-captions/references/reference-bar.md +47 -0
  45. package/.agents/skills/embedded-captions/references/scene-types.md +94 -0
  46. package/.agents/skills/embedded-captions/references/test-set.md +66 -0
  47. package/.agents/skills/embedded-captions/references/typographic-moves.md +266 -0
  48. package/.agents/skills/embedded-captions/references/typography-presets.md +63 -0
  49. package/.agents/skills/embedded-captions/scripts/audio-envelope.cjs +95 -0
  50. package/.agents/skills/embedded-captions/scripts/check-occlusion.cjs +250 -0
  51. package/.agents/skills/embedded-captions/scripts/check-overflow.cjs +194 -0
  52. package/.agents/skills/embedded-captions/scripts/check-rail-climax.cjs +233 -0
  53. package/.agents/skills/embedded-captions/scripts/check-timing.cjs +173 -0
  54. package/.agents/skills/embedded-captions/scripts/fill-timings.cjs +124 -0
  55. package/.agents/skills/embedded-captions/scripts/fit-fonts.cjs +158 -0
  56. package/.agents/skills/embedded-captions/scripts/gen-stroke-path.py +46 -0
  57. package/.agents/skills/embedded-captions/scripts/inject-fonts.cjs +169 -0
  58. package/.agents/skills/embedded-captions/scripts/lib-dna.cjs +201 -0
  59. package/.agents/skills/embedded-captions/scripts/make-cinematic.cjs +1205 -0
  60. package/.agents/skills/embedded-captions/scripts/make-composition.cjs +404 -0
  61. package/.agents/skills/embedded-captions/scripts/make-theme.cjs +8781 -0
  62. package/.agents/skills/embedded-captions/scripts/matte.cjs +294 -0
  63. package/.agents/skills/embedded-captions/scripts/measure-layout.cjs +293 -0
  64. package/.agents/skills/embedded-captions/scripts/prepare.sh +39 -0
  65. package/.agents/skills/embedded-captions/scripts/preview-frames.cjs +268 -0
  66. package/.agents/skills/embedded-captions/scripts/render-and-composite.sh +509 -0
  67. package/.agents/skills/embedded-captions/scripts/render-theme.sh +34 -0
  68. package/.agents/skills/embedded-captions/scripts/safe-zones.cjs +813 -0
  69. package/.agents/skills/embedded-captions/scripts/transcribe.cjs +349 -0
  70. package/.agents/skills/embedded-captions/themes/PORTING.md +49 -0
  71. package/.agents/skills/embedded-captions/themes/README.md +244 -0
  72. package/.agents/skills/embedded-captions/themes/anchor.json +27 -0
  73. package/.agents/skills/embedded-captions/themes/arcade.json +51 -0
  74. package/.agents/skills/embedded-captions/themes/aurora.json +41 -0
  75. package/.agents/skills/embedded-captions/themes/biolume.json +35 -0
  76. package/.agents/skills/embedded-captions/themes/brush.json +74 -0
  77. package/.agents/skills/embedded-captions/themes/chalkboard.json +52 -0
  78. package/.agents/skills/embedded-captions/themes/dossier.json +56 -0
  79. package/.agents/skills/embedded-captions/themes/graffiti.json +62 -0
  80. package/.agents/skills/embedded-captions/themes/hologram.json +41 -0
  81. package/.agents/skills/embedded-captions/themes/inkwater.json +43 -0
  82. package/.agents/skills/embedded-captions/themes/laser.json +46 -0
  83. package/.agents/skills/embedded-captions/themes/lastpage.json +33 -0
  84. package/.agents/skills/embedded-captions/themes/neonsign.json +53 -0
  85. package/.agents/skills/embedded-captions/themes/nightcity.json +56 -0
  86. package/.agents/skills/embedded-captions/themes/ordnance.json +54 -0
  87. package/.agents/skills/embedded-captions/themes/papercut.json +37 -0
  88. package/.agents/skills/embedded-captions/themes/popup.json +46 -0
  89. package/.agents/skills/embedded-captions/themes/ransom.json +62 -0
  90. package/.agents/skills/embedded-captions/themes/scoreboard.json +54 -0
  91. package/.agents/skills/embedded-captions/themes/spectrum.json +46 -0
  92. package/.agents/skills/embedded-captions/themes/stardust.json +29 -0
  93. package/.agents/skills/embedded-captions/themes/stomp.json +43 -0
  94. package/.agents/skills/embedded-captions/themes/terminal.json +49 -0
  95. package/.agents/skills/embedded-captions/themes/thunder.json +44 -0
  96. package/.agents/skills/embedded-captions/themes/transit.json +44 -0
  97. package/.agents/skills/embedded-captions/themes/vhs.json +47 -0
  98. package/.agents/skills/faceless-explainer/SKILL.md +209 -0
  99. package/.agents/skills/faceless-explainer/references/cut-catalog.md +215 -0
  100. package/.agents/skills/faceless-explainer/references/motion-language.md +156 -0
  101. package/.agents/skills/faceless-explainer/references/story-design.md +248 -0
  102. package/.agents/skills/faceless-explainer/references/visual-design.md +146 -0
  103. package/.agents/skills/faceless-explainer/scripts/assemble-index.mjs +570 -0
  104. package/.agents/skills/faceless-explainer/scripts/audio.mjs +260 -0
  105. package/.agents/skills/faceless-explainer/scripts/build-frame.mjs +536 -0
  106. package/.agents/skills/faceless-explainer/scripts/captions.mjs +508 -0
  107. package/.agents/skills/faceless-explainer/scripts/lib/assets.mjs +55 -0
  108. package/.agents/skills/faceless-explainer/scripts/lib/dimensions.mjs +45 -0
  109. package/.agents/skills/faceless-explainer/scripts/lib/storyboard.mjs +249 -0
  110. package/.agents/skills/faceless-explainer/scripts/lib/tokens.mjs +204 -0
  111. package/.agents/skills/faceless-explainer/scripts/lib/transition-registry.mjs +38 -0
  112. package/.agents/skills/faceless-explainer/scripts/lib/transitions.json +71 -0
  113. package/.agents/skills/faceless-explainer/scripts/transitions.mjs +320 -0
  114. package/.agents/skills/faceless-explainer/sub-agents/frame-worker.md +75 -0
  115. package/.agents/skills/flockposter/LICENSE +17 -0
  116. package/.agents/skills/flockposter/README.md +72 -0
  117. package/.agents/skills/flockposter/SKILL.md +562 -0
  118. package/.agents/skills/flockposter/examples/cli-instagram-reel.sh +21 -0
  119. package/.agents/skills/flockposter/examples/cli-multi-platform.json +69 -0
  120. package/.agents/skills/flockposter/examples/cli-tiktok-upload-only.sh +22 -0
  121. package/.agents/skills/flockposter/examples/cli-x-thread.sh +17 -0
  122. package/.agents/skills/flockposter/examples/cli-youtube-short.sh +21 -0
  123. package/.agents/skills/flockposter/examples/public-api-instagram-reel.json +28 -0
  124. package/.agents/skills/general-video/SKILL.md +143 -0
  125. package/.agents/skills/hyperframes/SKILL.md +160 -0
  126. package/.agents/skills/hyperframes-animation/SKILL.md +84 -0
  127. package/.agents/skills/hyperframes-animation/adapters/animate-text.md +64 -0
  128. package/.agents/skills/hyperframes-animation/adapters/animejs.md +114 -0
  129. package/.agents/skills/hyperframes-animation/adapters/css-animations.md +143 -0
  130. package/.agents/skills/hyperframes-animation/adapters/gsap-easing-and-stagger.md +118 -0
  131. package/.agents/skills/hyperframes-animation/adapters/gsap-timeline-and-labels.md +96 -0
  132. package/.agents/skills/hyperframes-animation/adapters/gsap-transforms-and-perf.md +96 -0
  133. package/.agents/skills/hyperframes-animation/adapters/gsap.md +105 -0
  134. package/.agents/skills/hyperframes-animation/adapters/html-in-canvas-patterns.md +507 -0
  135. package/.agents/skills/hyperframes-animation/adapters/lottie.md +117 -0
  136. package/.agents/skills/hyperframes-animation/adapters/three.md +131 -0
  137. package/.agents/skills/hyperframes-animation/adapters/typegpu.md +178 -0
  138. package/.agents/skills/hyperframes-animation/adapters/waapi.md +101 -0
  139. package/.agents/skills/hyperframes-animation/blueprints/comparison-split.md +27 -0
  140. package/.agents/skills/hyperframes-animation/blueprints/constellation-hub.md +44 -0
  141. package/.agents/skills/hyperframes-animation/blueprints/cta-morph-press.md +28 -0
  142. package/.agents/skills/hyperframes-animation/blueprints/cursor-ui-demo.md +57 -0
  143. package/.agents/skills/hyperframes-animation/blueprints/dataviz-countup.md +46 -0
  144. package/.agents/skills/hyperframes-animation/blueprints/device-surface-showcase.md +53 -0
  145. package/.agents/skills/hyperframes-animation/blueprints/grid-card-assemble.md +66 -0
  146. package/.agents/skills/hyperframes-animation/blueprints/kinetic-type-beats.md +78 -0
  147. package/.agents/skills/hyperframes-animation/blueprints/logo-assemble-lockup.md +69 -0
  148. package/.agents/skills/hyperframes-animation/blueprints/overwhelm-surround.md +28 -0
  149. package/.agents/skills/hyperframes-animation/blueprints/spatial-pan-stations.md +37 -0
  150. package/.agents/skills/hyperframes-animation/blueprints/ticker-takeover.md +29 -0
  151. package/.agents/skills/hyperframes-animation/blueprints/titlecard-reveal.md +42 -0
  152. package/.agents/skills/hyperframes-animation/blueprints/typewriter-reveal.md +51 -0
  153. package/.agents/skills/hyperframes-animation/blueprints/video-text-pivot.md +30 -0
  154. package/.agents/skills/hyperframes-animation/blueprints-index.md +146 -0
  155. package/.agents/skills/hyperframes-animation/examples/assets/avatars/02.avif +0 -0
  156. package/.agents/skills/hyperframes-animation/examples/assets/brands/github.avif +0 -0
  157. package/.agents/skills/hyperframes-animation/examples/assets/brands/nvidia.avif +0 -0
  158. package/.agents/skills/hyperframes-animation/examples/assets/brands/visa.avif +0 -0
  159. package/.agents/skills/hyperframes-animation/examples/assets/brands/zoominfo.avif +0 -0
  160. package/.agents/skills/hyperframes-animation/examples/brand-reveal-assemble-zoom.html +382 -0
  161. package/.agents/skills/hyperframes-animation/examples/comparison-split-cards.html +649 -0
  162. package/.agents/skills/hyperframes-animation/examples/concept-demo-decode-pan.html +520 -0
  163. package/.agents/skills/hyperframes-animation/examples/cta-morph-press.html +468 -0
  164. package/.agents/skills/hyperframes-animation/examples/cta-orbit-collapse.html +1298 -0
  165. package/.agents/skills/hyperframes-animation/examples/demo-page-scroll-spotlight.html +759 -0
  166. package/.agents/skills/hyperframes-animation/examples/hook-counter-burst.html +729 -0
  167. package/.agents/skills/hyperframes-animation/examples/messaging-multi-phrase.html +352 -0
  168. package/.agents/skills/hyperframes-animation/examples/metric-video-text-pivot.html +779 -0
  169. package/.agents/skills/hyperframes-animation/examples/problem-mockup-overwhelm.html +1374 -0
  170. package/.agents/skills/hyperframes-animation/examples/proof-logo-chain.html +861 -0
  171. package/.agents/skills/hyperframes-animation/examples/takeover-ticker-displace.html +347 -0
  172. package/.agents/skills/hyperframes-animation/examples/workflow-approve-press.html +606 -0
  173. package/.agents/skills/hyperframes-animation/rules/3d-page-scroll.md +227 -0
  174. package/.agents/skills/hyperframes-animation/rules/3d-text-depth-layers.md +297 -0
  175. package/.agents/skills/hyperframes-animation/rules/ai-tracking-box.md +382 -0
  176. package/.agents/skills/hyperframes-animation/rules/ambient-glow-bloom.md +305 -0
  177. package/.agents/skills/hyperframes-animation/rules/asr-keyword-glow.md +286 -0
  178. package/.agents/skills/hyperframes-animation/rules/avatar-cloud-network.md +371 -0
  179. package/.agents/skills/hyperframes-animation/rules/camera-cursor-tracking.md +246 -0
  180. package/.agents/skills/hyperframes-animation/rules/card-morph-anchor.md +267 -0
  181. package/.agents/skills/hyperframes-animation/rules/center-outward-expansion.md +227 -0
  182. package/.agents/skills/hyperframes-animation/rules/context-sensitive-cursor.md +257 -0
  183. package/.agents/skills/hyperframes-animation/rules/coordinate-target-zoom.md +332 -0
  184. package/.agents/skills/hyperframes-animation/rules/counting-dynamic-scale.md +283 -0
  185. package/.agents/skills/hyperframes-animation/rules/css-marker-patterns.md +373 -0
  186. package/.agents/skills/hyperframes-animation/rules/cursor-click-ripple.md +262 -0
  187. package/.agents/skills/hyperframes-animation/rules/depth-of-field-blur.md +313 -0
  188. package/.agents/skills/hyperframes-animation/rules/depth-scatter-assemble.md +303 -0
  189. package/.agents/skills/hyperframes-animation/rules/discrete-text-sequence.md +273 -0
  190. package/.agents/skills/hyperframes-animation/rules/dynamic-content-sequencing.md +307 -0
  191. package/.agents/skills/hyperframes-animation/rules/gsap-effects.md +299 -0
  192. package/.agents/skills/hyperframes-animation/rules/hacker-flip-3d.md +223 -0
  193. package/.agents/skills/hyperframes-animation/rules/kinetic-beat-slam.md +183 -0
  194. package/.agents/skills/hyperframes-animation/rules/motion-blur-streak.md +328 -0
  195. package/.agents/skills/hyperframes-animation/rules/multi-phase-camera.md +273 -0
  196. package/.agents/skills/hyperframes-animation/rules/orbit-3d-entry.md +301 -0
  197. package/.agents/skills/hyperframes-animation/rules/physics-press-reaction.md +350 -0
  198. package/.agents/skills/hyperframes-animation/rules/press-release-spring.md +296 -0
  199. package/.agents/skills/hyperframes-animation/rules/reactive-displacement.md +277 -0
  200. package/.agents/skills/hyperframes-animation/rules/scale-swap-transition.md +298 -0
  201. package/.agents/skills/hyperframes-animation/rules/sine-wave-loop.md +278 -0
  202. package/.agents/skills/hyperframes-animation/rules/split-tilt-cards.md +277 -0
  203. package/.agents/skills/hyperframes-animation/rules/spring-pop-entrance.md +273 -0
  204. package/.agents/skills/hyperframes-animation/rules/stat-bars-and-fills.md +156 -0
  205. package/.agents/skills/hyperframes-animation/rules/svg-icon-enrichment.md +329 -0
  206. package/.agents/skills/hyperframes-animation/rules/svg-path-draw.md +274 -0
  207. package/.agents/skills/hyperframes-animation/rules/vertical-spring-ticker.md +239 -0
  208. package/.agents/skills/hyperframes-animation/rules/viewport-change.md +349 -0
  209. package/.agents/skills/hyperframes-animation/rules-index.md +86 -0
  210. package/.agents/skills/hyperframes-animation/scripts/animation-map.mjs +606 -0
  211. package/.agents/skills/hyperframes-animation/scripts/package-loader.mjs +288 -0
  212. package/.agents/skills/hyperframes-animation/scripts/package-loader.test.mjs +62 -0
  213. package/.agents/skills/hyperframes-animation/techniques.md +507 -0
  214. package/.agents/skills/hyperframes-animation/transitions/TRANSITION-REGISTRY.md +167 -0
  215. package/.agents/skills/hyperframes-animation/transitions/catalog.md +127 -0
  216. package/.agents/skills/hyperframes-animation/transitions/css-3d.md +12 -0
  217. package/.agents/skills/hyperframes-animation/transitions/css-blur.md +51 -0
  218. package/.agents/skills/hyperframes-animation/transitions/css-cover.md +43 -0
  219. package/.agents/skills/hyperframes-animation/transitions/css-destruction.md +95 -0
  220. package/.agents/skills/hyperframes-animation/transitions/css-dissolve.md +66 -0
  221. package/.agents/skills/hyperframes-animation/transitions/css-distortion.md +45 -0
  222. package/.agents/skills/hyperframes-animation/transitions/css-grid.md +10 -0
  223. package/.agents/skills/hyperframes-animation/transitions/css-light.md +49 -0
  224. package/.agents/skills/hyperframes-animation/transitions/css-mechanical.md +30 -0
  225. package/.agents/skills/hyperframes-animation/transitions/css-other.md +25 -0
  226. package/.agents/skills/hyperframes-animation/transitions/css-push.md +41 -0
  227. package/.agents/skills/hyperframes-animation/transitions/css-radial.md +37 -0
  228. package/.agents/skills/hyperframes-animation/transitions/css-scale.md +24 -0
  229. package/.agents/skills/hyperframes-animation/transitions/overview.md +153 -0
  230. package/.agents/skills/hyperframes-cli/SKILL.md +113 -0
  231. package/.agents/skills/hyperframes-cli/references/doctor-browser.md +45 -0
  232. package/.agents/skills/hyperframes-cli/references/init-and-scaffold.md +55 -0
  233. package/.agents/skills/hyperframes-cli/references/lambda.md +132 -0
  234. package/.agents/skills/hyperframes-cli/references/lint-validate-inspect.md +121 -0
  235. package/.agents/skills/hyperframes-cli/references/preview-render.md +149 -0
  236. package/.agents/skills/hyperframes-cli/references/upgrade-info-misc.md +75 -0
  237. package/.agents/skills/hyperframes-core/SKILL.md +78 -0
  238. package/.agents/skills/hyperframes-core/references/composition-patterns.md +263 -0
  239. package/.agents/skills/hyperframes-core/references/data-attributes.md +70 -0
  240. package/.agents/skills/hyperframes-core/references/determinism-rules.md +68 -0
  241. package/.agents/skills/hyperframes-core/references/full-screen-motion.md +62 -0
  242. package/.agents/skills/hyperframes-core/references/minimal-composition.md +66 -0
  243. package/.agents/skills/hyperframes-core/references/script-format.md +49 -0
  244. package/.agents/skills/hyperframes-core/references/storyboard-format.md +95 -0
  245. package/.agents/skills/hyperframes-core/references/sub-compositions.md +237 -0
  246. package/.agents/skills/hyperframes-core/references/subagent-dispatch.md +41 -0
  247. package/.agents/skills/hyperframes-core/references/tailwind.md +125 -0
  248. package/.agents/skills/hyperframes-core/references/tracks-and-clips.md +76 -0
  249. package/.agents/skills/hyperframes-core/references/variables-and-media.md +90 -0
  250. package/.agents/skills/hyperframes-creative/SKILL.md +70 -0
  251. package/.agents/skills/hyperframes-creative/frame-presets/biennale-yellow/FRAME.md +289 -0
  252. package/.agents/skills/hyperframes-creative/frame-presets/biennale-yellow/caption-skin.html +221 -0
  253. package/.agents/skills/hyperframes-creative/frame-presets/biennale-yellow/frame-showcase.html +1214 -0
  254. package/.agents/skills/hyperframes-creative/frame-presets/blockframe/FRAME.md +275 -0
  255. package/.agents/skills/hyperframes-creative/frame-presets/blockframe/caption-skin.html +224 -0
  256. package/.agents/skills/hyperframes-creative/frame-presets/blockframe/frame-showcase.html +1347 -0
  257. package/.agents/skills/hyperframes-creative/frame-presets/blue-professional/FRAME.md +307 -0
  258. package/.agents/skills/hyperframes-creative/frame-presets/blue-professional/caption-skin.html +223 -0
  259. package/.agents/skills/hyperframes-creative/frame-presets/blue-professional/frame-showcase.html +1372 -0
  260. package/.agents/skills/hyperframes-creative/frame-presets/bold-poster/FRAME.md +275 -0
  261. package/.agents/skills/hyperframes-creative/frame-presets/bold-poster/caption-skin.html +230 -0
  262. package/.agents/skills/hyperframes-creative/frame-presets/bold-poster/frame-showcase.html +1140 -0
  263. package/.agents/skills/hyperframes-creative/frame-presets/broadside/FRAME.md +284 -0
  264. package/.agents/skills/hyperframes-creative/frame-presets/broadside/caption-skin.html +225 -0
  265. package/.agents/skills/hyperframes-creative/frame-presets/broadside/frame-showcase.html +1166 -0
  266. package/.agents/skills/hyperframes-creative/frame-presets/capsule/FRAME.md +284 -0
  267. package/.agents/skills/hyperframes-creative/frame-presets/capsule/caption-skin.html +224 -0
  268. package/.agents/skills/hyperframes-creative/frame-presets/capsule/frame-showcase.html +1465 -0
  269. package/.agents/skills/hyperframes-creative/frame-presets/cartesian/FRAME.md +278 -0
  270. package/.agents/skills/hyperframes-creative/frame-presets/cartesian/caption-skin.html +222 -0
  271. package/.agents/skills/hyperframes-creative/frame-presets/cartesian/frame-showcase.html +1263 -0
  272. package/.agents/skills/hyperframes-creative/frame-presets/claude/FRAME.md +277 -0
  273. package/.agents/skills/hyperframes-creative/frame-presets/claude/caption-skin.html +224 -0
  274. package/.agents/skills/hyperframes-creative/frame-presets/claude/frame-showcase.html +1439 -0
  275. package/.agents/skills/hyperframes-creative/frame-presets/cobalt-grid/FRAME.md +265 -0
  276. package/.agents/skills/hyperframes-creative/frame-presets/cobalt-grid/caption-skin.html +238 -0
  277. package/.agents/skills/hyperframes-creative/frame-presets/cobalt-grid/frame-showcase.html +1468 -0
  278. package/.agents/skills/hyperframes-creative/frame-presets/coral/FRAME.md +314 -0
  279. package/.agents/skills/hyperframes-creative/frame-presets/coral/caption-skin.html +226 -0
  280. package/.agents/skills/hyperframes-creative/frame-presets/coral/frame-showcase.html +1268 -0
  281. package/.agents/skills/hyperframes-creative/frame-presets/creative-mode/FRAME.md +333 -0
  282. package/.agents/skills/hyperframes-creative/frame-presets/creative-mode/caption-skin.html +227 -0
  283. package/.agents/skills/hyperframes-creative/frame-presets/creative-mode/frame-showcase.html +1330 -0
  284. package/.agents/skills/hyperframes-creative/frame-presets/daisy-days/FRAME.md +274 -0
  285. package/.agents/skills/hyperframes-creative/frame-presets/daisy-days/caption-skin.html +230 -0
  286. package/.agents/skills/hyperframes-creative/frame-presets/daisy-days/frame-showcase.html +1444 -0
  287. package/.agents/skills/hyperframes-creative/frame-presets/editorial-forest/FRAME.md +265 -0
  288. package/.agents/skills/hyperframes-creative/frame-presets/editorial-forest/caption-skin.html +223 -0
  289. package/.agents/skills/hyperframes-creative/frame-presets/editorial-forest/frame-showcase.html +1273 -0
  290. package/.agents/skills/hyperframes-creative/palettes/bold-energetic.md +14 -0
  291. package/.agents/skills/hyperframes-creative/palettes/clean-corporate.md +14 -0
  292. package/.agents/skills/hyperframes-creative/palettes/dark-premium.md +14 -0
  293. package/.agents/skills/hyperframes-creative/palettes/jewel-rich.md +14 -0
  294. package/.agents/skills/hyperframes-creative/palettes/monochrome.md +14 -0
  295. package/.agents/skills/hyperframes-creative/palettes/nature-earth.md +14 -0
  296. package/.agents/skills/hyperframes-creative/palettes/neon-electric.md +14 -0
  297. package/.agents/skills/hyperframes-creative/palettes/pastel-soft.md +14 -0
  298. package/.agents/skills/hyperframes-creative/palettes/warm-editorial.md +14 -0
  299. package/.agents/skills/hyperframes-creative/references/audio-reactive.md +76 -0
  300. package/.agents/skills/hyperframes-creative/references/beat-direction.md +164 -0
  301. package/.agents/skills/hyperframes-creative/references/composition-patterns.md +199 -0
  302. package/.agents/skills/hyperframes-creative/references/data-in-motion.md +19 -0
  303. package/.agents/skills/hyperframes-creative/references/design-adherence.md +19 -0
  304. package/.agents/skills/hyperframes-creative/references/design-picker.md +123 -0
  305. package/.agents/skills/hyperframes-creative/references/design-spec.md +55 -0
  306. package/.agents/skills/hyperframes-creative/references/house-style.md +73 -0
  307. package/.agents/skills/hyperframes-creative/references/motion-principles.md +150 -0
  308. package/.agents/skills/hyperframes-creative/references/narration.md +92 -0
  309. package/.agents/skills/hyperframes-creative/references/prompt-expansion.md +68 -0
  310. package/.agents/skills/hyperframes-creative/references/typography.md +218 -0
  311. package/.agents/skills/hyperframes-creative/references/video-composition.md +63 -0
  312. package/.agents/skills/hyperframes-creative/references/visual-styles.md +457 -0
  313. package/.agents/skills/hyperframes-creative/scripts/contrast-report.mjs +353 -0
  314. package/.agents/skills/hyperframes-creative/scripts/extract-audio-data.py +188 -0
  315. package/.agents/skills/hyperframes-creative/scripts/package-loader.mjs +288 -0
  316. package/.agents/skills/hyperframes-creative/scripts/package-loader.test.mjs +62 -0
  317. package/.agents/skills/hyperframes-creative/templates/design-picker.html +1432 -0
  318. package/.agents/skills/hyperframes-keyframes/SKILL.md +237 -0
  319. package/.agents/skills/hyperframes-keyframes/agents/openai.yaml +4 -0
  320. package/.agents/skills/hyperframes-keyframes/references/keyframe-patterns.md +106 -0
  321. package/.agents/skills/motion-graphics/SKILL.md +172 -0
  322. package/.agents/skills/motion-graphics/agents/builder.md +40 -0
  323. package/.agents/skills/motion-graphics/agents/director.md +53 -0
  324. package/.agents/skills/motion-graphics/agents/finalize.md +17 -0
  325. package/.agents/skills/motion-graphics/catalog-map.md +40 -0
  326. package/.agents/skills/motion-graphics/categories/asset-fusion/module.md +37 -0
  327. package/.agents/skills/motion-graphics/categories/charts/module.md +21 -0
  328. package/.agents/skills/motion-graphics/categories/kinetic-type/module.md +19 -0
  329. package/.agents/skills/motion-graphics/categories/logo-reveal/module.md +17 -0
  330. package/.agents/skills/motion-graphics/categories/lower-thirds/module.md +16 -0
  331. package/.agents/skills/motion-graphics/categories/maps/bake-basemap.mjs +273 -0
  332. package/.agents/skills/motion-graphics/categories/maps/module.md +61 -0
  333. package/.agents/skills/motion-graphics/categories/news/module.md +56 -0
  334. package/.agents/skills/motion-graphics/categories/stat/module.md +21 -0
  335. package/.agents/skills/motion-graphics/categories/tweet/module.md +16 -0
  336. package/.agents/skills/motion-graphics/categories/webpage/module.md +21 -0
  337. package/.agents/skills/motion-graphics/grounding/PROTOCOL.md +64 -0
  338. package/.agents/skills/motion-graphics/grounding/locate.mjs +227 -0
  339. package/.agents/skills/motion-graphics/phases/source/guide.md +21 -0
  340. package/.agents/skills/motion-graphics/references/builder-contract.md +38 -0
  341. package/.agents/skills/motion-graphics/references/motion-vocabulary.md +43 -0
  342. package/.agents/skills/motion-graphics/references/shot-plan-ir.md +54 -0
  343. package/.agents/skills/motion-graphics/samples/asset-fusion/_ref-circle-highlight.html +306 -0
  344. package/.agents/skills/product-launch-video/SKILL.md +208 -0
  345. package/.agents/skills/product-launch-video/references/cut-catalog.md +220 -0
  346. package/.agents/skills/product-launch-video/references/motion-language.md +156 -0
  347. package/.agents/skills/product-launch-video/references/story-design.md +373 -0
  348. package/.agents/skills/product-launch-video/references/visual-design.md +126 -0
  349. package/.agents/skills/product-launch-video/scripts/assemble-index.mjs +570 -0
  350. package/.agents/skills/product-launch-video/scripts/audio.mjs +260 -0
  351. package/.agents/skills/product-launch-video/scripts/build-frame.mjs +536 -0
  352. package/.agents/skills/product-launch-video/scripts/captions.mjs +508 -0
  353. package/.agents/skills/product-launch-video/scripts/lib/assets.mjs +55 -0
  354. package/.agents/skills/product-launch-video/scripts/lib/dimensions.mjs +45 -0
  355. package/.agents/skills/product-launch-video/scripts/lib/pad-frame-duration.mjs +36 -0
  356. package/.agents/skills/product-launch-video/scripts/lib/pad-frame-duration.test.mjs +76 -0
  357. package/.agents/skills/product-launch-video/scripts/lib/storyboard.mjs +249 -0
  358. package/.agents/skills/product-launch-video/scripts/lib/tokens.mjs +204 -0
  359. package/.agents/skills/product-launch-video/scripts/lib/transition-registry.mjs +38 -0
  360. package/.agents/skills/product-launch-video/scripts/lib/transitions.json +71 -0
  361. package/.agents/skills/product-launch-video/scripts/stage-assets.mjs +39 -0
  362. package/.agents/skills/product-launch-video/scripts/transitions.mjs +327 -0
  363. package/.agents/skills/product-launch-video/sub-agents/frame-worker.md +75 -0
  364. package/.agents/skills/slideshow/SKILL.md +550 -0
  365. package/.agents/skills/slideshow/references/standalone-harness.md +1020 -0
  366. package/.agents/skills/talking-head-recut/NOTICE.md +39 -0
  367. package/.agents/skills/talking-head-recut/SKILL.md +1195 -0
  368. package/.agents/skills/talking-head-recut/assets/vendor/gsap.min.js +10 -0
  369. package/.agents/skills/talking-head-recut/references/DESIGN_INDEX.md +145 -0
  370. package/.agents/skills/talking-head-recut/references/frames/clean.html +92 -0
  371. package/.agents/skills/talking-head-recut/references/frames/hairline.html +171 -0
  372. package/.agents/skills/talking-head-recut/references/frames/polaroid.html +131 -0
  373. package/.agents/skills/talking-head-recut/references/layouts/overlay.html +164 -0
  374. package/.agents/skills/talking-head-recut/references/layouts/pip.html +143 -0
  375. package/.agents/skills/talking-head-recut/references/layouts/split.html +121 -0
  376. package/.agents/skills/talking-head-recut/references/layouts/stack.html +109 -0
  377. package/.agents/skills/talking-head-recut/references/styles/academic.html +172 -0
  378. package/.agents/skills/talking-head-recut/references/styles/audit.html +170 -0
  379. package/.agents/skills/talking-head-recut/references/styles/editorial.html +189 -0
  380. package/.agents/skills/talking-head-recut/references/styles/geom.html +181 -0
  381. package/.agents/skills/talking-head-recut/references/styles/minimal.html +130 -0
  382. package/.agents/skills/talking-head-recut/references/styles/spotlight.html +142 -0
  383. package/.agents/skills/talking-head-recut/references/styles/swiss.html +188 -0
  384. package/.agents/skills/talking-head-recut/references/styles/terminal.html +196 -0
  385. package/.agents/skills/talking-head-recut/references/styles/whiteboard.html +170 -0
  386. package/.agents/skills/talking-head-recut/references/styles/xhs.html +206 -0
  387. package/.agents/skills/vidfarm-media/SKILL.md +85 -0
  388. package/.agents/skills/vidfarm-media/references/tts.md +54 -0
  389. package/.agents/skills/vidfarm-media/scripts/audio.mjs +628 -0
  390. package/.agents/skills/vidfarm-media/scripts/wait-bgm.mjs +31 -0
  391. package/.agents/skills/website-to-video/SKILL.md +145 -0
  392. package/.agents/skills/website-to-video/assets/sfx/CREDITS.md +35 -0
  393. package/.agents/skills/website-to-video/assets/sfx/manifest.json +97 -0
  394. package/.agents/skills/website-to-video/references/beat-builder-guide.md +263 -0
  395. package/.agents/skills/website-to-video/references/capabilities.md +713 -0
  396. package/.agents/skills/website-to-video/references/step-0-capture.md +55 -0
  397. package/.agents/skills/website-to-video/references/step-1-design.md +333 -0
  398. package/.agents/skills/website-to-video/references/step-2-brief.md +178 -0
  399. package/.agents/skills/website-to-video/references/step-3-storyboard.md +572 -0
  400. package/.agents/skills/website-to-video/references/step-4-vo.md +225 -0
  401. package/.agents/skills/website-to-video/references/step-5-build.md +483 -0
  402. package/.agents/skills/website-to-video/references/step-6-validate.md +341 -0
  403. package/.agents/skills/website-to-video/scripts/w2h-verify.mjs +759 -0
  404. package/SKILL.director.md +37 -0
  405. package/SKILL.platform.md +6 -1
  406. package/demo/dist/app.js +295 -11
  407. package/dist/src/app.js +317 -133
  408. package/dist/src/cli.js +529 -12
  409. package/dist/src/composition-runtime.js +262 -3
  410. package/dist/src/devcli/doctor.js +192 -0
  411. package/dist/src/devcli/hyperframes-cli.js +118 -0
  412. package/dist/src/devcli/skills.js +476 -0
  413. package/dist/src/devcli/stills.js +249 -0
  414. package/dist/src/editor-chat.js +255 -0
  415. package/dist/src/hyperframes/composition.js +5 -5
  416. package/dist/src/services/composition-lint.js +199 -0
  417. package/dist/src/services/hyperframes.js +67 -13
  418. package/package.json +2 -1
@@ -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`