takomi 2.5.1 → 2.5.4

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 (661) hide show
  1. package/.pi/agents/worker.md +32 -32
  2. package/.pi/extensions/oauth-router/README.md +3 -3
  3. package/.pi/extensions/oauth-router/config.ts +34 -34
  4. package/.pi/extensions/oauth-router/report-ui.ts +205 -205
  5. package/.pi/extensions/oauth-router/scripts/vibe-verify.py +5 -5
  6. package/.pi/extensions/takomi-context-manager/diagnostics.ts +560 -560
  7. package/.pi/extensions/takomi-context-manager/policy-tools.ts +93 -93
  8. package/.pi/extensions/takomi-context-manager/skill-categories.d.ts +11 -11
  9. package/.pi/extensions/takomi-context-manager/skill-tools.ts +208 -208
  10. package/.pi/extensions/takomi-context-manager/tool-renderers.ts +112 -112
  11. package/.pi/extensions/takomi-runtime/gate-provenance.ts +24 -24
  12. package/.pi/extensions/takomi-runtime/model-routing-defaults.ts +262 -262
  13. package/.pi/extensions/takomi-runtime/tool-renderers.ts +234 -234
  14. package/.pi/extensions/takomi-runtime/workflow-catalog.ts +54 -54
  15. package/.pi/extensions/takomi-subagents/async-lifecycle.ts +401 -401
  16. package/.pi/extensions/takomi-subagents/detached-results.ts +940 -940
  17. package/.pi/extensions/takomi-subagents/native-render.ts +253 -250
  18. package/.pi/extensions/takomi-subagents/result-heartbeat.ts +55 -55
  19. package/.pi/extensions/takomi-subagents/subagent-ux.ts +162 -162
  20. package/.pi/extensions/takomi-subagents/tool-runner.ts +25 -0
  21. package/.pi/takomi-profile.json +54 -54
  22. package/README.md +1 -1
  23. package/assets/.agent/skills/embedded-captions/CATALOG.md +93 -93
  24. package/assets/.agent/skills/embedded-captions/SKILL.md +286 -286
  25. package/assets/.agent/skills/embedded-captions/assets/brand/CDPR-fankit-terms.txt +35 -35
  26. package/assets/.agent/skills/embedded-captions/assets/brand/cyberpunk-widths.json +115 -115
  27. package/assets/.agent/skills/embedded-captions/assets/fonts/char-widths.json +2211 -2211
  28. package/assets/.agent/skills/embedded-captions/assets/strokefonts/HersheyScript1.svg +241 -241
  29. package/assets/.agent/skills/embedded-captions/assets/strokefonts/HersheyScriptMed.svg +241 -241
  30. package/assets/.agent/skills/embedded-captions/dna/README.md +148 -148
  31. package/assets/.agent/skills/embedded-captions/dna/chrome.json +68 -68
  32. package/assets/.agent/skills/embedded-captions/dna/cream.json +69 -69
  33. package/assets/.agent/skills/embedded-captions/dna/documentary.json +62 -62
  34. package/assets/.agent/skills/embedded-captions/dna/editorial.json +70 -70
  35. package/assets/.agent/skills/embedded-captions/dna/glitch.json +82 -82
  36. package/assets/.agent/skills/embedded-captions/dna/ink.json +65 -65
  37. package/assets/.agent/skills/embedded-captions/dna/keynote.json +62 -62
  38. package/assets/.agent/skills/embedded-captions/dna/loud.json +75 -75
  39. package/assets/.agent/skills/embedded-captions/dna/neon.json +58 -58
  40. package/assets/.agent/skills/embedded-captions/dna/velocity.json +89 -89
  41. package/assets/.agent/skills/embedded-captions/modes/cinematic/README.md +48 -48
  42. package/assets/.agent/skills/embedded-captions/modes/cinematic/_archive/champion/spec.md +98 -98
  43. package/assets/.agent/skills/embedded-captions/modes/cinematic/_archive/champion/template.html +188 -188
  44. package/assets/.agent/skills/embedded-captions/modes/cinematic/_archive/memory-wall/spec.md +134 -134
  45. package/assets/.agent/skills/embedded-captions/modes/cinematic/_archive/memory-wall/template.html +179 -179
  46. package/assets/.agent/skills/embedded-captions/modes/cinematic/_archive/portrait-header/spec.md +81 -81
  47. package/assets/.agent/skills/embedded-captions/modes/cinematic/_archive/portrait-header/template.html +170 -170
  48. package/assets/.agent/skills/embedded-captions/modes/cinematic/cinematic-cream/spec.md +16 -16
  49. package/assets/.agent/skills/embedded-captions/modes/cinematic/cinematic-cream/template.html +226 -226
  50. package/assets/.agent/skills/embedded-captions/modes/cinematic/engine.html +355 -355
  51. package/assets/.agent/skills/embedded-captions/modes/standard/_anatomy.md +233 -233
  52. package/assets/.agent/skills/embedded-captions/modes/standard/_motion.md +192 -192
  53. package/assets/.agent/skills/embedded-captions/modes/standard/fonts/build-fonts-css.cjs +97 -97
  54. package/assets/.agent/skills/embedded-captions/references/aesthetic-principles.md +168 -168
  55. package/assets/.agent/skills/embedded-captions/references/anti-patterns.md +188 -188
  56. package/assets/.agent/skills/embedded-captions/references/bespoke-vs-presets.md +178 -178
  57. package/assets/.agent/skills/embedded-captions/references/caption-grouping.md +130 -130
  58. package/assets/.agent/skills/embedded-captions/references/composition-craft.md +522 -522
  59. package/assets/.agent/skills/embedded-captions/references/direction-catalog.md +138 -138
  60. package/assets/.agent/skills/embedded-captions/references/example-renders/champion.html +371 -371
  61. package/assets/.agent/skills/embedded-captions/references/example-renders/memory-wall.html +334 -334
  62. package/assets/.agent/skills/embedded-captions/references/failure-modes.md +145 -145
  63. package/assets/.agent/skills/embedded-captions/references/layout-heuristics.md +238 -238
  64. package/assets/.agent/skills/embedded-captions/references/motion-vocabulary.md +148 -148
  65. package/assets/.agent/skills/embedded-captions/references/rail.md +68 -68
  66. package/assets/.agent/skills/embedded-captions/references/reference-bar.md +47 -47
  67. package/assets/.agent/skills/embedded-captions/references/scene-types.md +94 -94
  68. package/assets/.agent/skills/embedded-captions/references/test-set.md +66 -66
  69. package/assets/.agent/skills/embedded-captions/references/typographic-moves.md +266 -266
  70. package/assets/.agent/skills/embedded-captions/references/typography-presets.md +63 -63
  71. package/assets/.agent/skills/embedded-captions/scripts/audio-envelope.cjs +95 -95
  72. package/assets/.agent/skills/embedded-captions/scripts/check-occlusion.cjs +250 -250
  73. package/assets/.agent/skills/embedded-captions/scripts/check-overflow.cjs +194 -194
  74. package/assets/.agent/skills/embedded-captions/scripts/check-rail-climax.cjs +233 -233
  75. package/assets/.agent/skills/embedded-captions/scripts/check-timing.cjs +173 -173
  76. package/assets/.agent/skills/embedded-captions/scripts/fill-timings.cjs +124 -124
  77. package/assets/.agent/skills/embedded-captions/scripts/fit-fonts.cjs +158 -158
  78. package/assets/.agent/skills/embedded-captions/scripts/gen-stroke-path.py +46 -46
  79. package/assets/.agent/skills/embedded-captions/scripts/inject-fonts.cjs +169 -169
  80. package/assets/.agent/skills/embedded-captions/scripts/lib-dna.cjs +201 -201
  81. package/assets/.agent/skills/embedded-captions/scripts/make-cinematic.cjs +1205 -1205
  82. package/assets/.agent/skills/embedded-captions/scripts/make-composition.cjs +404 -404
  83. package/assets/.agent/skills/embedded-captions/scripts/make-theme.cjs +8781 -8781
  84. package/assets/.agent/skills/embedded-captions/scripts/matte.cjs +279 -279
  85. package/assets/.agent/skills/embedded-captions/scripts/measure-layout.cjs +293 -293
  86. package/assets/.agent/skills/embedded-captions/scripts/prepare.sh +39 -39
  87. package/assets/.agent/skills/embedded-captions/scripts/preview-frames.cjs +268 -268
  88. package/assets/.agent/skills/embedded-captions/scripts/render-and-composite.sh +469 -469
  89. package/assets/.agent/skills/embedded-captions/scripts/render-theme.sh +34 -34
  90. package/assets/.agent/skills/embedded-captions/scripts/safe-zones.cjs +813 -813
  91. package/assets/.agent/skills/embedded-captions/scripts/transcribe.cjs +332 -332
  92. package/assets/.agent/skills/embedded-captions/themes/PORTING.md +49 -49
  93. package/assets/.agent/skills/embedded-captions/themes/README.md +244 -244
  94. package/assets/.agent/skills/embedded-captions/themes/anchor.json +27 -27
  95. package/assets/.agent/skills/embedded-captions/themes/arcade.json +51 -51
  96. package/assets/.agent/skills/embedded-captions/themes/aurora.json +41 -41
  97. package/assets/.agent/skills/embedded-captions/themes/biolume.json +35 -35
  98. package/assets/.agent/skills/embedded-captions/themes/brush.json +74 -74
  99. package/assets/.agent/skills/embedded-captions/themes/chalkboard.json +52 -52
  100. package/assets/.agent/skills/embedded-captions/themes/dossier.json +56 -56
  101. package/assets/.agent/skills/embedded-captions/themes/graffiti.json +62 -62
  102. package/assets/.agent/skills/embedded-captions/themes/hologram.json +41 -41
  103. package/assets/.agent/skills/embedded-captions/themes/inkwater.json +43 -43
  104. package/assets/.agent/skills/embedded-captions/themes/laser.json +46 -46
  105. package/assets/.agent/skills/embedded-captions/themes/lastpage.json +33 -33
  106. package/assets/.agent/skills/embedded-captions/themes/neonsign.json +53 -53
  107. package/assets/.agent/skills/embedded-captions/themes/nightcity.json +56 -56
  108. package/assets/.agent/skills/embedded-captions/themes/ordnance.json +54 -54
  109. package/assets/.agent/skills/embedded-captions/themes/papercut.json +37 -37
  110. package/assets/.agent/skills/embedded-captions/themes/popup.json +46 -46
  111. package/assets/.agent/skills/embedded-captions/themes/ransom.json +62 -62
  112. package/assets/.agent/skills/embedded-captions/themes/scoreboard.json +54 -54
  113. package/assets/.agent/skills/embedded-captions/themes/spectrum.json +46 -46
  114. package/assets/.agent/skills/embedded-captions/themes/stardust.json +29 -29
  115. package/assets/.agent/skills/embedded-captions/themes/stomp.json +43 -43
  116. package/assets/.agent/skills/embedded-captions/themes/terminal.json +49 -49
  117. package/assets/.agent/skills/embedded-captions/themes/thunder.json +44 -44
  118. package/assets/.agent/skills/embedded-captions/themes/transit.json +44 -44
  119. package/assets/.agent/skills/embedded-captions/themes/vhs.json +47 -47
  120. package/assets/.agent/skills/faceless-explainer/SKILL.md +209 -209
  121. package/assets/.agent/skills/faceless-explainer/references/cut-catalog.md +215 -215
  122. package/assets/.agent/skills/faceless-explainer/references/motion-language.md +156 -156
  123. package/assets/.agent/skills/faceless-explainer/references/story-design.md +248 -248
  124. package/assets/.agent/skills/faceless-explainer/references/visual-design.md +146 -146
  125. package/assets/.agent/skills/faceless-explainer/scripts/assemble-index.mjs +570 -570
  126. package/assets/.agent/skills/faceless-explainer/scripts/audio.mjs +253 -253
  127. package/assets/.agent/skills/faceless-explainer/scripts/build-frame.mjs +536 -536
  128. package/assets/.agent/skills/faceless-explainer/scripts/captions.mjs +508 -508
  129. package/assets/.agent/skills/faceless-explainer/scripts/lib/assets.mjs +55 -55
  130. package/assets/.agent/skills/faceless-explainer/scripts/lib/dimensions.mjs +45 -45
  131. package/assets/.agent/skills/faceless-explainer/scripts/lib/storyboard.mjs +249 -249
  132. package/assets/.agent/skills/faceless-explainer/scripts/lib/tokens.mjs +204 -204
  133. package/assets/.agent/skills/faceless-explainer/scripts/lib/transition-registry.mjs +38 -38
  134. package/assets/.agent/skills/faceless-explainer/scripts/lib/transitions.json +71 -71
  135. package/assets/.agent/skills/faceless-explainer/scripts/transitions.mjs +320 -320
  136. package/assets/.agent/skills/faceless-explainer/sub-agents/frame-worker.md +75 -75
  137. package/assets/.agent/skills/figma/SKILL.md +121 -121
  138. package/assets/.agent/skills/general-video/SKILL.md +143 -143
  139. package/assets/.agent/skills/hyperframes/SKILL.md +164 -164
  140. package/assets/.agent/skills/hyperframes-animation/SKILL.md +84 -84
  141. package/assets/.agent/skills/hyperframes-animation/adapters/animate-text.md +64 -64
  142. package/assets/.agent/skills/hyperframes-animation/adapters/animejs.md +114 -114
  143. package/assets/.agent/skills/hyperframes-animation/adapters/css-animations.md +143 -143
  144. package/assets/.agent/skills/hyperframes-animation/adapters/gsap-easing-and-stagger.md +118 -118
  145. package/assets/.agent/skills/hyperframes-animation/adapters/gsap-timeline-and-labels.md +96 -96
  146. package/assets/.agent/skills/hyperframes-animation/adapters/gsap-transforms-and-perf.md +96 -96
  147. package/assets/.agent/skills/hyperframes-animation/adapters/gsap.md +105 -105
  148. package/assets/.agent/skills/hyperframes-animation/adapters/html-in-canvas-patterns.md +507 -507
  149. package/assets/.agent/skills/hyperframes-animation/adapters/lottie.md +117 -117
  150. package/assets/.agent/skills/hyperframes-animation/adapters/three.md +131 -131
  151. package/assets/.agent/skills/hyperframes-animation/adapters/typegpu.md +178 -178
  152. package/assets/.agent/skills/hyperframes-animation/adapters/waapi.md +101 -101
  153. package/assets/.agent/skills/hyperframes-animation/blueprints/comparison-split.md +27 -27
  154. package/assets/.agent/skills/hyperframes-animation/blueprints/constellation-hub.md +44 -44
  155. package/assets/.agent/skills/hyperframes-animation/blueprints/cta-morph-press.md +28 -28
  156. package/assets/.agent/skills/hyperframes-animation/blueprints/cursor-ui-demo.md +57 -57
  157. package/assets/.agent/skills/hyperframes-animation/blueprints/dataviz-countup.md +46 -46
  158. package/assets/.agent/skills/hyperframes-animation/blueprints/device-surface-showcase.md +53 -53
  159. package/assets/.agent/skills/hyperframes-animation/blueprints/grid-card-assemble.md +66 -66
  160. package/assets/.agent/skills/hyperframes-animation/blueprints/kinetic-type-beats.md +78 -78
  161. package/assets/.agent/skills/hyperframes-animation/blueprints/logo-assemble-lockup.md +69 -69
  162. package/assets/.agent/skills/hyperframes-animation/blueprints/overwhelm-surround.md +28 -28
  163. package/assets/.agent/skills/hyperframes-animation/blueprints/spatial-pan-stations.md +37 -37
  164. package/assets/.agent/skills/hyperframes-animation/blueprints/ticker-takeover.md +29 -29
  165. package/assets/.agent/skills/hyperframes-animation/blueprints/titlecard-reveal.md +42 -42
  166. package/assets/.agent/skills/hyperframes-animation/blueprints/typewriter-reveal.md +51 -51
  167. package/assets/.agent/skills/hyperframes-animation/blueprints/video-text-pivot.md +30 -30
  168. package/assets/.agent/skills/hyperframes-animation/blueprints-index.md +146 -146
  169. package/assets/.agent/skills/hyperframes-animation/examples/brand-reveal-assemble-zoom.html +382 -382
  170. package/assets/.agent/skills/hyperframes-animation/examples/comparison-split-cards.html +649 -649
  171. package/assets/.agent/skills/hyperframes-animation/examples/concept-demo-decode-pan.html +520 -520
  172. package/assets/.agent/skills/hyperframes-animation/examples/cta-morph-press.html +468 -468
  173. package/assets/.agent/skills/hyperframes-animation/examples/cta-orbit-collapse.html +1298 -1298
  174. package/assets/.agent/skills/hyperframes-animation/examples/demo-page-scroll-spotlight.html +759 -759
  175. package/assets/.agent/skills/hyperframes-animation/examples/hook-counter-burst.html +729 -729
  176. package/assets/.agent/skills/hyperframes-animation/examples/messaging-multi-phrase.html +352 -352
  177. package/assets/.agent/skills/hyperframes-animation/examples/metric-video-text-pivot.html +779 -779
  178. package/assets/.agent/skills/hyperframes-animation/examples/problem-mockup-overwhelm.html +1374 -1374
  179. package/assets/.agent/skills/hyperframes-animation/examples/proof-logo-chain.html +861 -861
  180. package/assets/.agent/skills/hyperframes-animation/examples/takeover-ticker-displace.html +347 -347
  181. package/assets/.agent/skills/hyperframes-animation/examples/workflow-approve-press.html +606 -606
  182. package/assets/.agent/skills/hyperframes-animation/rules/3d-page-scroll.md +227 -227
  183. package/assets/.agent/skills/hyperframes-animation/rules/3d-text-depth-layers.md +297 -297
  184. package/assets/.agent/skills/hyperframes-animation/rules/ai-tracking-box.md +382 -382
  185. package/assets/.agent/skills/hyperframes-animation/rules/ambient-glow-bloom.md +305 -305
  186. package/assets/.agent/skills/hyperframes-animation/rules/asr-keyword-glow.md +286 -286
  187. package/assets/.agent/skills/hyperframes-animation/rules/avatar-cloud-network.md +371 -371
  188. package/assets/.agent/skills/hyperframes-animation/rules/camera-cursor-tracking.md +246 -246
  189. package/assets/.agent/skills/hyperframes-animation/rules/card-morph-anchor.md +267 -267
  190. package/assets/.agent/skills/hyperframes-animation/rules/center-outward-expansion.md +227 -227
  191. package/assets/.agent/skills/hyperframes-animation/rules/context-sensitive-cursor.md +257 -257
  192. package/assets/.agent/skills/hyperframes-animation/rules/coordinate-target-zoom.md +332 -332
  193. package/assets/.agent/skills/hyperframes-animation/rules/counting-dynamic-scale.md +283 -283
  194. package/assets/.agent/skills/hyperframes-animation/rules/css-marker-patterns.md +373 -373
  195. package/assets/.agent/skills/hyperframes-animation/rules/cursor-click-ripple.md +262 -262
  196. package/assets/.agent/skills/hyperframes-animation/rules/depth-of-field-blur.md +313 -313
  197. package/assets/.agent/skills/hyperframes-animation/rules/depth-scatter-assemble.md +303 -303
  198. package/assets/.agent/skills/hyperframes-animation/rules/discrete-text-sequence.md +273 -273
  199. package/assets/.agent/skills/hyperframes-animation/rules/dynamic-content-sequencing.md +307 -307
  200. package/assets/.agent/skills/hyperframes-animation/rules/gsap-effects.md +299 -299
  201. package/assets/.agent/skills/hyperframes-animation/rules/hacker-flip-3d.md +223 -223
  202. package/assets/.agent/skills/hyperframes-animation/rules/kinetic-beat-slam.md +183 -183
  203. package/assets/.agent/skills/hyperframes-animation/rules/motion-blur-streak.md +328 -328
  204. package/assets/.agent/skills/hyperframes-animation/rules/multi-phase-camera.md +273 -273
  205. package/assets/.agent/skills/hyperframes-animation/rules/orbit-3d-entry.md +301 -301
  206. package/assets/.agent/skills/hyperframes-animation/rules/physics-press-reaction.md +350 -350
  207. package/assets/.agent/skills/hyperframes-animation/rules/press-release-spring.md +296 -296
  208. package/assets/.agent/skills/hyperframes-animation/rules/reactive-displacement.md +277 -277
  209. package/assets/.agent/skills/hyperframes-animation/rules/scale-swap-transition.md +298 -298
  210. package/assets/.agent/skills/hyperframes-animation/rules/sine-wave-loop.md +278 -278
  211. package/assets/.agent/skills/hyperframes-animation/rules/split-tilt-cards.md +277 -277
  212. package/assets/.agent/skills/hyperframes-animation/rules/spring-pop-entrance.md +273 -273
  213. package/assets/.agent/skills/hyperframes-animation/rules/stat-bars-and-fills.md +156 -156
  214. package/assets/.agent/skills/hyperframes-animation/rules/svg-icon-enrichment.md +329 -329
  215. package/assets/.agent/skills/hyperframes-animation/rules/svg-path-draw.md +274 -274
  216. package/assets/.agent/skills/hyperframes-animation/rules/vertical-spring-ticker.md +239 -239
  217. package/assets/.agent/skills/hyperframes-animation/rules/viewport-change.md +349 -349
  218. package/assets/.agent/skills/hyperframes-animation/rules-index.md +86 -86
  219. package/assets/.agent/skills/hyperframes-animation/scripts/animation-map.mjs +606 -606
  220. package/assets/.agent/skills/hyperframes-animation/scripts/package-loader.mjs +288 -288
  221. package/assets/.agent/skills/hyperframes-animation/scripts/package-loader.test.mjs +62 -62
  222. package/assets/.agent/skills/hyperframes-animation/techniques.md +507 -507
  223. package/assets/.agent/skills/hyperframes-animation/transitions/TRANSITION-REGISTRY.md +167 -167
  224. package/assets/.agent/skills/hyperframes-animation/transitions/catalog.md +127 -127
  225. package/assets/.agent/skills/hyperframes-animation/transitions/css-3d.md +12 -12
  226. package/assets/.agent/skills/hyperframes-animation/transitions/css-blur.md +51 -51
  227. package/assets/.agent/skills/hyperframes-animation/transitions/css-cover.md +43 -43
  228. package/assets/.agent/skills/hyperframes-animation/transitions/css-destruction.md +95 -95
  229. package/assets/.agent/skills/hyperframes-animation/transitions/css-dissolve.md +66 -66
  230. package/assets/.agent/skills/hyperframes-animation/transitions/css-distortion.md +45 -45
  231. package/assets/.agent/skills/hyperframes-animation/transitions/css-grid.md +10 -10
  232. package/assets/.agent/skills/hyperframes-animation/transitions/css-light.md +49 -49
  233. package/assets/.agent/skills/hyperframes-animation/transitions/css-mechanical.md +30 -30
  234. package/assets/.agent/skills/hyperframes-animation/transitions/css-other.md +25 -25
  235. package/assets/.agent/skills/hyperframes-animation/transitions/css-push.md +41 -41
  236. package/assets/.agent/skills/hyperframes-animation/transitions/css-radial.md +37 -37
  237. package/assets/.agent/skills/hyperframes-animation/transitions/css-scale.md +24 -24
  238. package/assets/.agent/skills/hyperframes-animation/transitions/overview.md +153 -153
  239. package/assets/.agent/skills/hyperframes-cli/SKILL.md +113 -113
  240. package/assets/.agent/skills/hyperframes-cli/references/doctor-browser.md +45 -45
  241. package/assets/.agent/skills/hyperframes-cli/references/init-and-scaffold.md +51 -51
  242. package/assets/.agent/skills/hyperframes-cli/references/lambda.md +132 -132
  243. package/assets/.agent/skills/hyperframes-cli/references/lint-validate-inspect.md +121 -121
  244. package/assets/.agent/skills/hyperframes-cli/references/preview-render.md +164 -164
  245. package/assets/.agent/skills/hyperframes-cli/references/upgrade-info-misc.md +75 -75
  246. package/assets/.agent/skills/hyperframes-core/SKILL.md +78 -78
  247. package/assets/.agent/skills/hyperframes-core/references/composition-patterns.md +263 -263
  248. package/assets/.agent/skills/hyperframes-core/references/data-attributes.md +70 -70
  249. package/assets/.agent/skills/hyperframes-core/references/determinism-rules.md +68 -68
  250. package/assets/.agent/skills/hyperframes-core/references/full-screen-motion.md +62 -62
  251. package/assets/.agent/skills/hyperframes-core/references/minimal-composition.md +66 -66
  252. package/assets/.agent/skills/hyperframes-core/references/script-format.md +49 -49
  253. package/assets/.agent/skills/hyperframes-core/references/storyboard-format.md +95 -95
  254. package/assets/.agent/skills/hyperframes-core/references/sub-compositions.md +237 -237
  255. package/assets/.agent/skills/hyperframes-core/references/subagent-dispatch.md +41 -41
  256. package/assets/.agent/skills/hyperframes-core/references/tailwind.md +125 -125
  257. package/assets/.agent/skills/hyperframes-core/references/tracks-and-clips.md +76 -76
  258. package/assets/.agent/skills/hyperframes-core/references/variables-and-media.md +90 -90
  259. package/assets/.agent/skills/hyperframes-creative/SKILL.md +70 -70
  260. package/assets/.agent/skills/hyperframes-creative/frame-presets/biennale-yellow/FRAME.md +289 -289
  261. package/assets/.agent/skills/hyperframes-creative/frame-presets/biennale-yellow/caption-skin.html +221 -221
  262. package/assets/.agent/skills/hyperframes-creative/frame-presets/biennale-yellow/frame-showcase.html +1214 -1214
  263. package/assets/.agent/skills/hyperframes-creative/frame-presets/blockframe/FRAME.md +275 -275
  264. package/assets/.agent/skills/hyperframes-creative/frame-presets/blockframe/caption-skin.html +224 -224
  265. package/assets/.agent/skills/hyperframes-creative/frame-presets/blockframe/frame-showcase.html +1347 -1347
  266. package/assets/.agent/skills/hyperframes-creative/frame-presets/blue-professional/FRAME.md +307 -307
  267. package/assets/.agent/skills/hyperframes-creative/frame-presets/blue-professional/caption-skin.html +223 -223
  268. package/assets/.agent/skills/hyperframes-creative/frame-presets/blue-professional/frame-showcase.html +1372 -1372
  269. package/assets/.agent/skills/hyperframes-creative/frame-presets/bold-poster/FRAME.md +275 -275
  270. package/assets/.agent/skills/hyperframes-creative/frame-presets/bold-poster/caption-skin.html +230 -230
  271. package/assets/.agent/skills/hyperframes-creative/frame-presets/bold-poster/frame-showcase.html +1140 -1140
  272. package/assets/.agent/skills/hyperframes-creative/frame-presets/broadside/FRAME.md +284 -284
  273. package/assets/.agent/skills/hyperframes-creative/frame-presets/broadside/caption-skin.html +225 -225
  274. package/assets/.agent/skills/hyperframes-creative/frame-presets/broadside/frame-showcase.html +1166 -1166
  275. package/assets/.agent/skills/hyperframes-creative/frame-presets/capsule/FRAME.md +284 -284
  276. package/assets/.agent/skills/hyperframes-creative/frame-presets/capsule/caption-skin.html +224 -224
  277. package/assets/.agent/skills/hyperframes-creative/frame-presets/capsule/frame-showcase.html +1465 -1465
  278. package/assets/.agent/skills/hyperframes-creative/frame-presets/cartesian/FRAME.md +278 -278
  279. package/assets/.agent/skills/hyperframes-creative/frame-presets/cartesian/caption-skin.html +222 -222
  280. package/assets/.agent/skills/hyperframes-creative/frame-presets/cartesian/frame-showcase.html +1263 -1263
  281. package/assets/.agent/skills/hyperframes-creative/frame-presets/claude/FRAME.md +277 -277
  282. package/assets/.agent/skills/hyperframes-creative/frame-presets/claude/caption-skin.html +224 -224
  283. package/assets/.agent/skills/hyperframes-creative/frame-presets/claude/frame-showcase.html +1439 -1439
  284. package/assets/.agent/skills/hyperframes-creative/frame-presets/cobalt-grid/FRAME.md +265 -265
  285. package/assets/.agent/skills/hyperframes-creative/frame-presets/cobalt-grid/caption-skin.html +238 -238
  286. package/assets/.agent/skills/hyperframes-creative/frame-presets/cobalt-grid/frame-showcase.html +1468 -1468
  287. package/assets/.agent/skills/hyperframes-creative/frame-presets/coral/FRAME.md +314 -314
  288. package/assets/.agent/skills/hyperframes-creative/frame-presets/coral/caption-skin.html +226 -226
  289. package/assets/.agent/skills/hyperframes-creative/frame-presets/coral/frame-showcase.html +1268 -1268
  290. package/assets/.agent/skills/hyperframes-creative/frame-presets/creative-mode/FRAME.md +333 -333
  291. package/assets/.agent/skills/hyperframes-creative/frame-presets/creative-mode/caption-skin.html +227 -227
  292. package/assets/.agent/skills/hyperframes-creative/frame-presets/creative-mode/frame-showcase.html +1330 -1330
  293. package/assets/.agent/skills/hyperframes-creative/frame-presets/daisy-days/FRAME.md +274 -274
  294. package/assets/.agent/skills/hyperframes-creative/frame-presets/daisy-days/caption-skin.html +230 -230
  295. package/assets/.agent/skills/hyperframes-creative/frame-presets/daisy-days/frame-showcase.html +1444 -1444
  296. package/assets/.agent/skills/hyperframes-creative/frame-presets/editorial-forest/FRAME.md +265 -265
  297. package/assets/.agent/skills/hyperframes-creative/frame-presets/editorial-forest/caption-skin.html +223 -223
  298. package/assets/.agent/skills/hyperframes-creative/frame-presets/editorial-forest/frame-showcase.html +1273 -1273
  299. package/assets/.agent/skills/hyperframes-creative/palettes/bold-energetic.md +14 -14
  300. package/assets/.agent/skills/hyperframes-creative/palettes/clean-corporate.md +14 -14
  301. package/assets/.agent/skills/hyperframes-creative/palettes/dark-premium.md +14 -14
  302. package/assets/.agent/skills/hyperframes-creative/palettes/jewel-rich.md +14 -14
  303. package/assets/.agent/skills/hyperframes-creative/palettes/monochrome.md +14 -14
  304. package/assets/.agent/skills/hyperframes-creative/palettes/nature-earth.md +14 -14
  305. package/assets/.agent/skills/hyperframes-creative/palettes/neon-electric.md +14 -14
  306. package/assets/.agent/skills/hyperframes-creative/palettes/pastel-soft.md +14 -14
  307. package/assets/.agent/skills/hyperframes-creative/palettes/warm-editorial.md +14 -14
  308. package/assets/.agent/skills/hyperframes-creative/references/audio-reactive.md +76 -76
  309. package/assets/.agent/skills/hyperframes-creative/references/beat-direction.md +164 -164
  310. package/assets/.agent/skills/hyperframes-creative/references/composition-patterns.md +199 -199
  311. package/assets/.agent/skills/hyperframes-creative/references/data-in-motion.md +19 -19
  312. package/assets/.agent/skills/hyperframes-creative/references/design-adherence.md +19 -19
  313. package/assets/.agent/skills/hyperframes-creative/references/design-picker.md +123 -123
  314. package/assets/.agent/skills/hyperframes-creative/references/design-spec.md +55 -55
  315. package/assets/.agent/skills/hyperframes-creative/references/house-style.md +73 -73
  316. package/assets/.agent/skills/hyperframes-creative/references/motion-principles.md +150 -150
  317. package/assets/.agent/skills/hyperframes-creative/references/narration.md +92 -92
  318. package/assets/.agent/skills/hyperframes-creative/references/prompt-expansion.md +68 -68
  319. package/assets/.agent/skills/hyperframes-creative/references/typography.md +218 -218
  320. package/assets/.agent/skills/hyperframes-creative/references/video-composition.md +63 -63
  321. package/assets/.agent/skills/hyperframes-creative/references/visual-styles.md +457 -457
  322. package/assets/.agent/skills/hyperframes-creative/scripts/contrast-report.mjs +353 -353
  323. package/assets/.agent/skills/hyperframes-creative/scripts/extract-audio-data.py +188 -188
  324. package/assets/.agent/skills/hyperframes-creative/scripts/package-loader.mjs +288 -288
  325. package/assets/.agent/skills/hyperframes-creative/scripts/package-loader.test.mjs +62 -62
  326. package/assets/.agent/skills/hyperframes-creative/templates/design-picker.html +1432 -1432
  327. package/assets/.agent/skills/hyperframes-keyframes/SKILL.md +237 -237
  328. package/assets/.agent/skills/hyperframes-keyframes/agents/openai.yaml +4 -4
  329. package/assets/.agent/skills/hyperframes-keyframes/references/keyframe-patterns.md +106 -106
  330. package/assets/.agent/skills/hyperframes-media/SKILL.md +97 -97
  331. package/assets/.agent/skills/hyperframes-media/assets/sfx/CREDITS.md +35 -35
  332. package/assets/.agent/skills/hyperframes-media/assets/sfx/manifest.json +97 -97
  333. package/assets/.agent/skills/hyperframes-media/references/bgm.md +72 -72
  334. package/assets/.agent/skills/hyperframes-media/references/captions/authoring.md +159 -159
  335. package/assets/.agent/skills/hyperframes-media/references/captions/motion.md +87 -87
  336. package/assets/.agent/skills/hyperframes-media/references/captions/transcript-handling.md +97 -97
  337. package/assets/.agent/skills/hyperframes-media/references/remove-background.md +143 -143
  338. package/assets/.agent/skills/hyperframes-media/references/requirements.md +29 -29
  339. package/assets/.agent/skills/hyperframes-media/references/sfx.md +42 -42
  340. package/assets/.agent/skills/hyperframes-media/references/transcribe.md +52 -52
  341. package/assets/.agent/skills/hyperframes-media/references/tts-to-captions.md +24 -24
  342. package/assets/.agent/skills/hyperframes-media/references/tts.md +135 -135
  343. package/assets/.agent/skills/hyperframes-media/scripts/audio.mjs +293 -293
  344. package/assets/.agent/skills/hyperframes-media/scripts/heygen-tts.mjs +121 -121
  345. package/assets/.agent/skills/hyperframes-media/scripts/lib/bgm.mjs +235 -235
  346. package/assets/.agent/skills/hyperframes-media/scripts/lib/concurrency.mjs +14 -14
  347. package/assets/.agent/skills/hyperframes-media/scripts/lib/concurrency.test.mjs +41 -41
  348. package/assets/.agent/skills/hyperframes-media/scripts/lib/heygen.mjs +131 -131
  349. package/assets/.agent/skills/hyperframes-media/scripts/lib/sfx.mjs +128 -128
  350. package/assets/.agent/skills/hyperframes-media/scripts/lib/tts.mjs +298 -298
  351. package/assets/.agent/skills/hyperframes-media/scripts/lib/tts.spawn.test.mjs +97 -97
  352. package/assets/.agent/skills/hyperframes-media/scripts/lib/tts.test.mjs +66 -66
  353. package/assets/.agent/skills/hyperframes-media/scripts/lyria-recipe.py +128 -128
  354. package/assets/.agent/skills/hyperframes-media/scripts/wait-bgm.mjs +167 -167
  355. package/assets/.agent/skills/hyperframes-registry/SKILL.md +101 -101
  356. package/assets/.agent/skills/hyperframes-registry/examples/add-block.md +51 -51
  357. package/assets/.agent/skills/hyperframes-registry/examples/add-component.md +73 -73
  358. package/assets/.agent/skills/hyperframes-registry/references/contributing.md +166 -166
  359. package/assets/.agent/skills/hyperframes-registry/references/demo-html-pattern.md +54 -54
  360. package/assets/.agent/skills/hyperframes-registry/references/discovery.md +215 -215
  361. package/assets/.agent/skills/hyperframes-registry/references/install-locations.md +45 -45
  362. package/assets/.agent/skills/hyperframes-registry/references/templates.md +417 -417
  363. package/assets/.agent/skills/hyperframes-registry/references/wiring-blocks.md +61 -61
  364. package/assets/.agent/skills/hyperframes-registry/references/wiring-components.md +39 -39
  365. package/assets/.agent/skills/media-use/SKILL.md +124 -124
  366. package/assets/.agent/skills/media-use/scripts/eval.mjs +369 -369
  367. package/assets/.agent/skills/media-use/scripts/lib/adopt.mjs +112 -112
  368. package/assets/.agent/skills/media-use/scripts/lib/bgm-provider.mjs +20 -20
  369. package/assets/.agent/skills/media-use/scripts/lib/brand-provider.mjs +59 -59
  370. package/assets/.agent/skills/media-use/scripts/lib/cache.mjs +114 -114
  371. package/assets/.agent/skills/media-use/scripts/lib/freeze.mjs +26 -26
  372. package/assets/.agent/skills/media-use/scripts/lib/heygen-search.mjs +51 -51
  373. package/assets/.agent/skills/media-use/scripts/lib/image-provider.mjs +44 -44
  374. package/assets/.agent/skills/media-use/scripts/lib/index-gen.mjs +63 -63
  375. package/assets/.agent/skills/media-use/scripts/lib/manifest.mjs +91 -91
  376. package/assets/.agent/skills/media-use/scripts/lib/manifest.test.mjs +293 -293
  377. package/assets/.agent/skills/media-use/scripts/lib/probe.mjs +39 -39
  378. package/assets/.agent/skills/media-use/scripts/lib/probe.test.mjs +31 -31
  379. package/assets/.agent/skills/media-use/scripts/lib/providers.mjs +29 -29
  380. package/assets/.agent/skills/media-use/scripts/lib/sfx-provider.mjs +23 -23
  381. package/assets/.agent/skills/media-use/scripts/resolve.mjs +247 -247
  382. package/assets/.agent/skills/media-use/scripts/resolve.test.mjs +247 -247
  383. package/assets/.agent/skills/motion-graphics/SKILL.md +172 -172
  384. package/assets/.agent/skills/motion-graphics/agents/builder.md +40 -40
  385. package/assets/.agent/skills/motion-graphics/agents/director.md +53 -53
  386. package/assets/.agent/skills/motion-graphics/agents/finalize.md +17 -17
  387. package/assets/.agent/skills/motion-graphics/catalog-map.md +40 -40
  388. package/assets/.agent/skills/motion-graphics/categories/asset-fusion/module.md +37 -37
  389. package/assets/.agent/skills/motion-graphics/categories/charts/module.md +21 -21
  390. package/assets/.agent/skills/motion-graphics/categories/kinetic-type/module.md +19 -19
  391. package/assets/.agent/skills/motion-graphics/categories/logo-reveal/module.md +17 -17
  392. package/assets/.agent/skills/motion-graphics/categories/lower-thirds/module.md +16 -16
  393. package/assets/.agent/skills/motion-graphics/categories/maps/bake-basemap.mjs +273 -273
  394. package/assets/.agent/skills/motion-graphics/categories/maps/module.md +61 -61
  395. package/assets/.agent/skills/motion-graphics/categories/news/module.md +56 -56
  396. package/assets/.agent/skills/motion-graphics/categories/stat/module.md +21 -21
  397. package/assets/.agent/skills/motion-graphics/categories/tweet/module.md +16 -16
  398. package/assets/.agent/skills/motion-graphics/categories/webpage/module.md +21 -21
  399. package/assets/.agent/skills/motion-graphics/grounding/PROTOCOL.md +64 -64
  400. package/assets/.agent/skills/motion-graphics/grounding/locate.mjs +227 -227
  401. package/assets/.agent/skills/motion-graphics/phases/source/guide.md +21 -21
  402. package/assets/.agent/skills/motion-graphics/references/builder-contract.md +38 -38
  403. package/assets/.agent/skills/motion-graphics/references/motion-vocabulary.md +43 -43
  404. package/assets/.agent/skills/motion-graphics/references/shot-plan-ir.md +54 -54
  405. package/assets/.agent/skills/motion-graphics/samples/asset-fusion/_ref-circle-highlight.html +306 -306
  406. package/assets/.agent/skills/music-to-video/SKILL.md +197 -197
  407. package/assets/.agent/skills/music-to-video/references/frame-skeleton.md +100 -100
  408. package/assets/.agent/skills/music-to-video/references/montage.md +58 -58
  409. package/assets/.agent/skills/music-to-video/references/motion-primitive-catalog.md +75 -75
  410. package/assets/.agent/skills/music-to-video/references/motion-primitives/3d-card-flip/index.html +154 -154
  411. package/assets/.agent/skills/music-to-video/references/motion-primitives/assets/gsap.min.js +11 -11
  412. package/assets/.agent/skills/music-to-video/references/motion-primitives/bg-flow-field/index.html +326 -326
  413. package/assets/.agent/skills/music-to-video/references/motion-primitives/binary-decrypt/index.html +120 -120
  414. package/assets/.agent/skills/music-to-video/references/motion-primitives/blur-resolve/index.html +95 -95
  415. package/assets/.agent/skills/music-to-video/references/motion-primitives/braam-punch/index.html +135 -135
  416. package/assets/.agent/skills/music-to-video/references/motion-primitives/chromatic-split/index.html +146 -146
  417. package/assets/.agent/skills/music-to-video/references/motion-primitives/chrome-sweep/index.html +103 -103
  418. package/assets/.agent/skills/music-to-video/references/motion-primitives/counting-punch/index.html +154 -154
  419. package/assets/.agent/skills/music-to-video/references/motion-primitives/crash-zoom-in/index.html +155 -155
  420. package/assets/.agent/skills/music-to-video/references/motion-primitives/datamosh-smear/index.html +166 -166
  421. package/assets/.agent/skills/music-to-video/references/motion-primitives/directional-fill/index.html +133 -133
  422. package/assets/.agent/skills/music-to-video/references/motion-primitives/dolly-zoom/index.html +137 -137
  423. package/assets/.agent/skills/music-to-video/references/motion-primitives/electric-arc/index.html +144 -144
  424. package/assets/.agent/skills/music-to-video/references/motion-primitives/flash-cut/index.html +132 -132
  425. package/assets/.agent/skills/music-to-video/references/motion-primitives/gooey-metaball/index.html +241 -241
  426. package/assets/.agent/skills/music-to-video/references/motion-primitives/hard-cut/index.html +117 -117
  427. package/assets/.agent/skills/music-to-video/references/motion-primitives/hypercut-whip/index.html +79 -79
  428. package/assets/.agent/skills/music-to-video/references/motion-primitives/iris-open/index.html +104 -104
  429. package/assets/.agent/skills/music-to-video/references/motion-primitives/kinetic-letter-in/index.html +92 -92
  430. package/assets/.agent/skills/music-to-video/references/motion-primitives/liquid-morph/index.html +131 -131
  431. package/assets/.agent/skills/music-to-video/references/motion-primitives/mask-reveal/index.html +109 -109
  432. package/assets/.agent/skills/music-to-video/references/motion-primitives/mosaic-pack/index.html +124 -124
  433. package/assets/.agent/skills/music-to-video/references/motion-primitives/neon-flicker/index.html +108 -108
  434. package/assets/.agent/skills/music-to-video/references/motion-primitives/outline-to-fill/index.html +117 -117
  435. package/assets/.agent/skills/music-to-video/references/motion-primitives/palette-flip/index.html +132 -132
  436. package/assets/.agent/skills/music-to-video/references/motion-primitives/particle-burst/index.html +141 -141
  437. package/assets/.agent/skills/music-to-video/references/motion-primitives/pixel-dissolve/index.html +121 -121
  438. package/assets/.agent/skills/music-to-video/references/motion-primitives/radial-burst-lines/index.html +160 -160
  439. package/assets/.agent/skills/music-to-video/references/motion-primitives/screen-shake/index.html +113 -113
  440. package/assets/.agent/skills/music-to-video/references/motion-primitives/slot-machine-reveal/index.html +130 -130
  441. package/assets/.agent/skills/music-to-video/references/motion-primitives/spotlight-sweep/index.html +137 -137
  442. package/assets/.agent/skills/music-to-video/references/motion-primitives/staggered-exit/index.html +117 -117
  443. package/assets/.agent/skills/music-to-video/references/motion-primitives/text-spectral-rays/USAGE.md +42 -42
  444. package/assets/.agent/skills/music-to-video/references/motion-primitives/text-spectral-rays/index.html +313 -313
  445. package/assets/.agent/skills/music-to-video/references/motion-primitives/text-wave-distort/index.html +136 -136
  446. package/assets/.agent/skills/music-to-video/references/motion-primitives/tile-mosaic/index.html +144 -144
  447. package/assets/.agent/skills/music-to-video/references/motion-primitives/typewriter-reveal/index.html +122 -122
  448. package/assets/.agent/skills/music-to-video/references/motion-primitives/word-grid-burst/index.html +126 -126
  449. package/assets/.agent/skills/music-to-video/references/planning.md +104 -104
  450. package/assets/.agent/skills/music-to-video/references/storyboard-format.md +94 -94
  451. package/assets/.agent/skills/music-to-video/references/template-catalog.md +106 -106
  452. package/assets/.agent/skills/music-to-video/references/templates/card-flyby/index.html +527 -527
  453. package/assets/.agent/skills/music-to-video/references/templates/card-flyby/program.json +13 -13
  454. package/assets/.agent/skills/music-to-video/references/templates/held-message-living-field/index.html +485 -485
  455. package/assets/.agent/skills/music-to-video/references/templates/held-text-strobe-burst/index.html +302 -302
  456. package/assets/.agent/skills/music-to-video/references/templates/intro-kinetic-cascade/index.html +610 -610
  457. package/assets/.agent/skills/music-to-video/references/templates/intro-kinetic-cascade/program.json +41 -41
  458. package/assets/.agent/skills/music-to-video/references/templates/logo-split-lockup-pulse/index.html +596 -596
  459. package/assets/.agent/skills/music-to-video/references/templates/poster-tile-mosaic/index.html +589 -589
  460. package/assets/.agent/skills/music-to-video/references/templates/poster-tile-mosaic/program.json +25 -25
  461. package/assets/.agent/skills/music-to-video/references/templates/roll-flipbook-word-cycle/index.html +267 -267
  462. package/assets/.agent/skills/music-to-video/references/templates/split-anchor-word-slot/index.html +594 -594
  463. package/assets/.agent/skills/music-to-video/references/templates/split-anchor-word-slot/program.json +39 -39
  464. package/assets/.agent/skills/music-to-video/references/templates/typewriter-phrase-keyword-shuffle/index.html +238 -238
  465. package/assets/.agent/skills/music-to-video/scripts/analyze-beatgrid.py +531 -531
  466. package/assets/.agent/skills/music-to-video/scripts/assemble-index.mjs +218 -218
  467. package/assets/.agent/skills/music-to-video/scripts/lib/storyboard.mjs +249 -249
  468. package/assets/.agent/skills/music-to-video/scripts/stage-assets.mjs +58 -58
  469. package/assets/.agent/skills/music-to-video/scripts/validate-plan.mjs +161 -161
  470. package/assets/.agent/skills/music-to-video/sub-agents/frame-worker.md +75 -75
  471. package/assets/.agent/skills/pr-to-video/SKILL.md +240 -240
  472. package/assets/.agent/skills/pr-to-video/references/code-vocabulary.md +111 -111
  473. package/assets/.agent/skills/pr-to-video/references/cut-catalog.md +215 -215
  474. package/assets/.agent/skills/pr-to-video/references/motion-language.md +156 -156
  475. package/assets/.agent/skills/pr-to-video/references/story-design.md +211 -211
  476. package/assets/.agent/skills/pr-to-video/references/visual-design.md +164 -164
  477. package/assets/.agent/skills/pr-to-video/scripts/assemble-index.mjs +570 -570
  478. package/assets/.agent/skills/pr-to-video/scripts/audio.mjs +253 -253
  479. package/assets/.agent/skills/pr-to-video/scripts/build-frame.mjs +536 -536
  480. package/assets/.agent/skills/pr-to-video/scripts/captions.mjs +508 -508
  481. package/assets/.agent/skills/pr-to-video/scripts/fetch-people-avatars.mjs +157 -157
  482. package/assets/.agent/skills/pr-to-video/scripts/fetch-pr.mjs +164 -164
  483. package/assets/.agent/skills/pr-to-video/scripts/ingest.mjs +539 -539
  484. package/assets/.agent/skills/pr-to-video/scripts/lib/assets.mjs +55 -55
  485. package/assets/.agent/skills/pr-to-video/scripts/lib/dimensions.mjs +45 -45
  486. package/assets/.agent/skills/pr-to-video/scripts/lib/storyboard.mjs +249 -249
  487. package/assets/.agent/skills/pr-to-video/scripts/lib/tokens.mjs +204 -204
  488. package/assets/.agent/skills/pr-to-video/scripts/lib/transition-registry.mjs +38 -38
  489. package/assets/.agent/skills/pr-to-video/scripts/lib/transitions.json +71 -71
  490. package/assets/.agent/skills/pr-to-video/scripts/transitions.mjs +320 -320
  491. package/assets/.agent/skills/pr-to-video/sub-agents/frame-worker.md +95 -95
  492. package/assets/.agent/skills/product-launch-video/SKILL.md +208 -208
  493. package/assets/.agent/skills/product-launch-video/references/cut-catalog.md +220 -220
  494. package/assets/.agent/skills/product-launch-video/references/motion-language.md +156 -156
  495. package/assets/.agent/skills/product-launch-video/references/story-design.md +373 -373
  496. package/assets/.agent/skills/product-launch-video/references/visual-design.md +126 -126
  497. package/assets/.agent/skills/product-launch-video/scripts/assemble-index.mjs +570 -570
  498. package/assets/.agent/skills/product-launch-video/scripts/audio.mjs +253 -253
  499. package/assets/.agent/skills/product-launch-video/scripts/build-frame.mjs +536 -536
  500. package/assets/.agent/skills/product-launch-video/scripts/captions.mjs +508 -508
  501. package/assets/.agent/skills/product-launch-video/scripts/lib/assets.mjs +55 -55
  502. package/assets/.agent/skills/product-launch-video/scripts/lib/dimensions.mjs +45 -45
  503. package/assets/.agent/skills/product-launch-video/scripts/lib/storyboard.mjs +249 -249
  504. package/assets/.agent/skills/product-launch-video/scripts/lib/tokens.mjs +204 -204
  505. package/assets/.agent/skills/product-launch-video/scripts/lib/transition-registry.mjs +38 -38
  506. package/assets/.agent/skills/product-launch-video/scripts/lib/transitions.json +71 -71
  507. package/assets/.agent/skills/product-launch-video/scripts/stage-assets.mjs +39 -39
  508. package/assets/.agent/skills/product-launch-video/scripts/transitions.mjs +320 -320
  509. package/assets/.agent/skills/product-launch-video/sub-agents/frame-worker.md +75 -75
  510. package/assets/.agent/skills/remotion/SKILL.md +357 -38
  511. package/assets/.agent/skills/remotion/rules/3d.md +5 -5
  512. package/assets/.agent/skills/remotion/rules/assets/text-animations-word-highlight.tsx +1 -6
  513. package/assets/.agent/skills/remotion/rules/audio-visualization.md +198 -0
  514. package/assets/.agent/skills/remotion/rules/audio.md +1 -4
  515. package/assets/.agent/skills/remotion/rules/calculate-metadata.md +48 -18
  516. package/assets/.agent/skills/remotion/rules/compositions.md +16 -24
  517. package/assets/.agent/skills/remotion/rules/display-captions.md +79 -21
  518. package/assets/.agent/skills/remotion/rules/effects.md +235 -0
  519. package/assets/.agent/skills/remotion/rules/ffmpeg.md +34 -0
  520. package/assets/.agent/skills/remotion/rules/get-audio-duration.md +13 -13
  521. package/assets/.agent/skills/remotion/rules/get-video-dimensions.md +1 -1
  522. package/assets/.agent/skills/remotion/rules/get-video-duration.md +12 -10
  523. package/assets/.agent/skills/remotion/rules/gifs.md +21 -18
  524. package/assets/.agent/skills/remotion/rules/google-fonts.md +72 -0
  525. package/assets/.agent/skills/remotion/rules/html-in-canvas.md +122 -0
  526. package/assets/.agent/skills/remotion/rules/images.md +5 -64
  527. package/assets/.agent/skills/remotion/rules/import-srt-captions.md +9 -7
  528. package/assets/.agent/skills/remotion/rules/light-leaks.md +73 -0
  529. package/assets/.agent/skills/remotion/rules/local-fonts.md +65 -0
  530. package/assets/.agent/skills/remotion/rules/lottie.md +10 -8
  531. package/assets/.agent/skills/remotion/rules/maplibre.md +458 -0
  532. package/assets/.agent/skills/remotion/rules/measuring-dom-nodes.md +0 -1
  533. package/assets/.agent/skills/remotion/rules/measuring-text.md +2 -5
  534. package/assets/.agent/skills/remotion/rules/parameters.md +21 -10
  535. package/assets/.agent/skills/remotion/rules/sequencing.md +35 -9
  536. package/assets/.agent/skills/remotion/rules/sfx.md +51 -0
  537. package/assets/.agent/skills/remotion/rules/silence-detection.md +71 -0
  538. package/assets/.agent/skills/remotion/rules/subtitles.md +36 -0
  539. package/assets/.agent/skills/remotion/rules/tailwind.md +2 -2
  540. package/assets/.agent/skills/remotion/rules/timing.md +89 -106
  541. package/assets/.agent/skills/remotion/rules/transcribe-captions.md +58 -7
  542. package/assets/.agent/skills/remotion/rules/transitions.md +117 -42
  543. package/assets/.agent/skills/remotion/rules/transparent-videos.md +106 -0
  544. package/assets/.agent/skills/remotion/rules/trimming.md +1 -3
  545. package/assets/.agent/skills/remotion/rules/video-layout.md +68 -0
  546. package/assets/.agent/skills/remotion/rules/voiceover.md +99 -0
  547. package/assets/.agent/skills/remotion-real-ui-video/SKILL.md +264 -264
  548. package/assets/.agent/skills/remotion-real-ui-video/references/anti-patterns.md +114 -114
  549. package/assets/.agent/skills/remotion-real-ui-video/references/completion-checklist.md +75 -75
  550. package/assets/.agent/skills/remotion-real-ui-video/references/real-ui-bridge-example.md +93 -93
  551. package/assets/.agent/skills/remotion-to-hyperframes/SKILL.md +127 -127
  552. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/run.sh +249 -249
  553. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/README.md +41 -41
  554. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/expected.json +26 -26
  555. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/hf-src/index.html +61 -61
  556. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/package.json +14 -14
  557. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/remotion.config.ts +13 -13
  558. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/src/Root.tsx +13 -13
  559. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/src/TitleCard.tsx +34 -34
  560. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/src/index.ts +4 -4
  561. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/tsconfig.json +15 -15
  562. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/README.md +54 -54
  563. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/expected.json +29 -29
  564. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/hf-src/index.html +118 -118
  565. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/package.json +14 -14
  566. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/remotion.config.ts +13 -13
  567. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/src/MultiScene.tsx +105 -105
  568. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/src/Root.tsx +13 -13
  569. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/src/index.ts +4 -4
  570. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/tsconfig.json +15 -15
  571. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/setup.sh +34 -34
  572. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/README.md +85 -85
  573. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/expected.json +41 -41
  574. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/hf-src/index.html +269 -269
  575. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/package.json +15 -15
  576. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/remotion.config.ts +13 -13
  577. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/Root.tsx +27 -27
  578. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/Stargazed.tsx +37 -37
  579. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/components/AnimatedNumber.tsx +23 -23
  580. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/components/StatCard.tsx +59 -59
  581. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/components/UnderlinedText.tsx +47 -47
  582. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/index.ts +4 -4
  583. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/scenes/OutroScene.tsx +18 -18
  584. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/scenes/StatsScene.tsx +34 -34
  585. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/scenes/TitleScene.tsx +55 -55
  586. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/tsconfig.json +15 -15
  587. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/README.md +51 -51
  588. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/01-use-state.tsx +29 -29
  589. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/02-use-effect-deps.tsx +29 -29
  590. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/03-async-metadata.tsx +39 -39
  591. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/04-third-party-react.tsx +30 -30
  592. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/05-lambda-config.tsx +38 -38
  593. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/06-warnings-only.tsx +36 -36
  594. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/07-custom-hook.tsx +28 -28
  595. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/08-mixed.tsx +41 -41
  596. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/expected.json +85 -85
  597. package/assets/.agent/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/validate.sh +110 -110
  598. package/assets/.agent/skills/remotion-to-hyperframes/references/api-map.md +142 -142
  599. package/assets/.agent/skills/remotion-to-hyperframes/references/escape-hatch.md +115 -115
  600. package/assets/.agent/skills/remotion-to-hyperframes/references/eval.md +140 -140
  601. package/assets/.agent/skills/remotion-to-hyperframes/references/fonts.md +112 -112
  602. package/assets/.agent/skills/remotion-to-hyperframes/references/limitations.md +136 -136
  603. package/assets/.agent/skills/remotion-to-hyperframes/references/lottie.md +121 -121
  604. package/assets/.agent/skills/remotion-to-hyperframes/references/media.md +149 -149
  605. package/assets/.agent/skills/remotion-to-hyperframes/references/parameters.md +167 -167
  606. package/assets/.agent/skills/remotion-to-hyperframes/references/sequencing.md +195 -195
  607. package/assets/.agent/skills/remotion-to-hyperframes/references/timing.md +165 -165
  608. package/assets/.agent/skills/remotion-to-hyperframes/references/transitions.md +114 -114
  609. package/assets/.agent/skills/remotion-to-hyperframes/scripts/frame_strip.sh +107 -107
  610. package/assets/.agent/skills/remotion-to-hyperframes/scripts/lint_source.py +358 -358
  611. package/assets/.agent/skills/remotion-to-hyperframes/scripts/render_diff.sh +103 -103
  612. package/assets/.agent/skills/remotion-to-hyperframes/scripts/tests/fixtures/blocker.tsx +50 -50
  613. package/assets/.agent/skills/remotion-to-hyperframes/scripts/tests/fixtures/clean.tsx +46 -46
  614. package/assets/.agent/skills/remotion-to-hyperframes/scripts/tests/smoke.sh +90 -90
  615. package/assets/.agent/skills/shared-resend-portfolio/SKILL.md +124 -124
  616. package/assets/.agent/skills/slideshow/SKILL.md +550 -550
  617. package/assets/.agent/skills/slideshow/references/standalone-harness.md +1020 -1020
  618. package/assets/.agent/skills/talking-head-recut/NOTICE.md +39 -39
  619. package/assets/.agent/skills/talking-head-recut/SKILL.md +1191 -1191
  620. package/assets/.agent/skills/talking-head-recut/assets/vendor/gsap.min.js +10 -10
  621. package/assets/.agent/skills/talking-head-recut/references/DESIGN_INDEX.md +145 -145
  622. package/assets/.agent/skills/talking-head-recut/references/frames/clean.html +92 -92
  623. package/assets/.agent/skills/talking-head-recut/references/frames/hairline.html +171 -171
  624. package/assets/.agent/skills/talking-head-recut/references/frames/polaroid.html +131 -131
  625. package/assets/.agent/skills/talking-head-recut/references/layouts/overlay.html +164 -164
  626. package/assets/.agent/skills/talking-head-recut/references/layouts/pip.html +143 -143
  627. package/assets/.agent/skills/talking-head-recut/references/layouts/split.html +121 -121
  628. package/assets/.agent/skills/talking-head-recut/references/layouts/stack.html +109 -109
  629. package/assets/.agent/skills/talking-head-recut/references/styles/academic.html +172 -172
  630. package/assets/.agent/skills/talking-head-recut/references/styles/audit.html +170 -170
  631. package/assets/.agent/skills/talking-head-recut/references/styles/editorial.html +189 -189
  632. package/assets/.agent/skills/talking-head-recut/references/styles/geom.html +181 -181
  633. package/assets/.agent/skills/talking-head-recut/references/styles/minimal.html +130 -130
  634. package/assets/.agent/skills/talking-head-recut/references/styles/spotlight.html +142 -142
  635. package/assets/.agent/skills/talking-head-recut/references/styles/swiss.html +188 -188
  636. package/assets/.agent/skills/talking-head-recut/references/styles/terminal.html +196 -196
  637. package/assets/.agent/skills/talking-head-recut/references/styles/whiteboard.html +170 -170
  638. package/assets/.agent/skills/talking-head-recut/references/styles/xhs.html +206 -206
  639. package/assets/.agent/skills/website-to-video/SKILL.md +145 -145
  640. package/assets/.agent/skills/website-to-video/assets/sfx/CREDITS.md +35 -35
  641. package/assets/.agent/skills/website-to-video/assets/sfx/manifest.json +97 -97
  642. package/assets/.agent/skills/website-to-video/references/beat-builder-guide.md +263 -263
  643. package/assets/.agent/skills/website-to-video/references/capabilities.md +713 -713
  644. package/assets/.agent/skills/website-to-video/references/step-0-capture.md +55 -55
  645. package/assets/.agent/skills/website-to-video/references/step-1-design.md +333 -333
  646. package/assets/.agent/skills/website-to-video/references/step-2-brief.md +178 -178
  647. package/assets/.agent/skills/website-to-video/references/step-3-storyboard.md +572 -572
  648. package/assets/.agent/skills/website-to-video/references/step-4-vo.md +230 -230
  649. package/assets/.agent/skills/website-to-video/references/step-5-build.md +483 -483
  650. package/assets/.agent/skills/website-to-video/references/step-6-validate.md +341 -341
  651. package/assets/.agent/skills/website-to-video/scripts/w2h-verify.mjs +759 -759
  652. package/package.json +5 -4
  653. package/src/pi-takomi-core/workflows.ts +86 -86
  654. package/src/takomi-stats.js +5 -5
  655. package/assets/.agent/skills/remotion/rules/animations.md +0 -29
  656. package/assets/.agent/skills/remotion/rules/assets.md +0 -78
  657. package/assets/.agent/skills/remotion/rules/can-decode.md +0 -75
  658. package/assets/.agent/skills/remotion/rules/charts.md +0 -58
  659. package/assets/.agent/skills/remotion/rules/extract-frames.md +0 -229
  660. package/assets/.agent/skills/remotion/rules/fonts.md +0 -152
  661. package/assets/.agent/skills/remotion/rules/maps.md +0 -403
@@ -1,66 +1,66 @@
1
- # grid-card-assemble — Grid / Card Assemble
2
-
3
- **intent**: N items (tiles / cards / logos / list-lines) self-assemble in a staggered cascade into a grid or vertical list and hold — a "look how much / who / what it does" beat that enumerates breadth at once; an optional camera zoom-OUT pulls back to reveal the assembled array sitting inside a vaster whole.
4
-
5
- **roles served**
6
-
7
- - Key_Feature (from key-feature-card-grid-assemble): a grid of labeled feature tiles/pills (icon + label) cascades one-by-one into a 2-col-brick / 3×3 grid, then holds near-static with a slow push-in — enumerate many capabilities, no live UI, no cursor.
8
- - Key_Feature (from key-feature-glass-card-camera-reveal): open TIGHT on 2–3 glowing icons; a camera zoom-OUT unfolds a row of glassmorphism cards that grow from behind the icons (icons shrink to card headers), center card scales forward, the group floats, then sweeps out — a "pillars revealed at once" reveal variant of the same assemble shape.
9
- - Benefits (from benefits-vertical-list): short value phrases populate a single vertical list ~1 item/sec, co-resident and accumulating; each line enters via a spring marker-pop + check-draw + pill mask-wipe, OR the whole stack snaps up one slot per beat (slot-machine) so the newest lands in the bright focal slot.
10
- - Social_Proof (from social-proof-logo-grid-zoom-out): a wall of partner/app logos builds into a center grid (whole-enter / randomized pop-in / column slide-up), an optional headline + accent-gradient proof-number fills in above, then a continuous camera zoom-OUT shrinks the array to reveal a vast ecosystem; optional fixed HUD/viewfinder brackets; optional grid slide-up fly-out exit.
11
-
12
- **duration**: 3.0–10.5s (Social_Proof 3.0–6s · Key_Feature grid 5.8–7.3s · Key_Feature glass-card 6.5s · Benefits list 6.5–10.5s, scaling ~1 item/sec with count)
13
-
14
- **shot structure** (consolidated template — concrete motion verbs, [slots])
15
-
16
- - **Scene 1 (0.0–~1.0s) — open + first arrivals.** On a `[gradient / radial / dark background]` (optional `[dot-grid / drifting-watermark]` texture), an empty `[grid or list region]` is established and items begin to ASSEMBLE in a quick staggered cascade (~0.04–0.08s gap; list pacing ~1 item/sec). Each `[item: feature tile / pill / logo tile / benefit line]` fades + slides/scales a short distance directly into its slot (low drama — no scatter, no big bounce; spring overshoot reserved for accent markers). Camera static. An opening `[headline / hook]` may fill in line-by-line above the array, with any `[proof number]` counting up in an `[accent gradient]`.
17
- - **Scene 2 (~1.0s–~Xs) — array resolves + holds.** Remaining items finish arriving; layout resolves into the final `[2-col-brick / 3×3 grid / dense mosaic / stacked list]`. The completed array HOLDS, alive but resting: a gentle continuous parallax/sine FLOAT on the tiles and/or a slow camera push-in (faint scale-up). Optional `[accent-color]` glow TRAVELS across/behind the tiles.
18
- - **Scene 3 (~Xs–end) — settle / reveal / exit.** Everything settles and holds to the end, OR the optional camera modifier runs (see below), OR a `[closing line / CTA]` book-ends the array.
19
-
20
- Variants (where roles diverge from the template):
21
-
22
- - **Variant — Key_Feature grid**: items are labeled `[icon + feature-label]` tiles/pills assembling into a 2-col-brick / 3×3 grid; near-static hold with slow push-in + optional traveling-glow sweep; headline book-ends (`[hook]` → `[CTA]`). No camera reveal.
23
- - **Variant — Key_Feature glass-card-reveal**: the assemble is CAMERA-DRIVEN, not element-stagger. Open tight on `[2–3 glowing icons]`; camera zoom-OUT grows `[N]` glass cards out from behind the icons (icons shrink ~50% to become card headers), `[center card]` scales ~105% and moves forward to overlap the sides (quick spring); cards hold side-by-side with continuous parallax float; exit = fast motion-blur SWEEP slides the cards off-frame.
24
- - **Variant — Benefits vertical-list**: a single vertical `[benefit-line]` stack, ~1 item/sec, two sub-modes — (a) BUILD: each line stays fully lit; entry = `[marker]` spring-pop + `[check/icon]` draw-in + `[pill]` mask-wipe of the text; (b) SNAP: the whole stack steps up one slot per beat (~0.1s eased) so the newest line lands in the bright focal slot and lines leaving it dim by position. Static camera; optional perpetual `[decorative orbit/disc]` on the opposite side. No camera reveal.
25
- - **Variant — Social_Proof logo-wall-zoom-out**: intro beat (`[trusted-by headline]` card OR a `[product screenshot]`) crossfades/cuts to a center logo grid that builds (whole-enter / randomized pop-in / column slide-up); a continuous camera zoom-OUT then shrinks the whole grid toward center to reveal a vast ecosystem and holds; optional fixed HUD/viewfinder brackets; optional exit = whole grid SLIDES UP and flies out through the top.
26
-
27
- **motion vocabulary**: item stagger-assemble (fade + short slide/scale into slot) · brick/grid/list layout resolve · randomized pop-in · column slide-up · vertical-list step (slot-machine snap-and-hold) · spring-overshoot marker pop · check/icon draw-in · pill/label mask-wipe reveal · dim-by-position de-emphasis · line-by-line headline fill · accent-gradient number count-up · near-static hold · gentle parallax/sine float on hold · slow camera push-in · camera zoom-OUT reveal (continuous OR phased pull-back) · cards-grow-from-behind-icons · icon-shrink-to-header · center-card scale-up + forward overlap (spring) · traveling-glow sweep · fixed HUD/viewfinder brackets · motion-blur slide-out sweep (exit) · grid slide-up fly-out (exit) · book-end headline fade · perpetual decorative orbit/loop.
28
-
29
- **rule mapping** (motion verb → `rule-id`)
30
-
31
- - item stagger-assemble into slot → `center-outward-expansion` (per-item stagger + short-path slide variant; for a wall too dense for a true center burst, use it in its "starting partially-spread"/direct-into-slot form — see merge tension)
32
- - brick/grid/list layout resolve → `center-outward-expansion` (target positions = final layout slots)
33
- - randomized pop-in stagger → `gsap-effects` (stagger recipe; randomized `from`/order)
34
- - column slide-up into grid → `gsap-effects` (per-column staggered slide-up)
35
- - vertical-list step / slot-machine snap-and-hold → `vertical-spring-ticker` (STEPS = number of line advances)
36
- - spring-overshoot marker pop → `spring-pop-entrance` (back.out spring) — also `gsap-effects` for the staggered pop chain
37
- - check / icon draw-in inside marker → `svg-path-draw`
38
- - live line-art icon in a tile (internal parts) → `svg-icon-enrichment`
39
- - pill / label mask-wipe text reveal → `techniques.md` (clip-path reveal)
40
- - dim-by-position de-emphasis → `gsap-effects` (per-line opacity by slot position; no dedicated rule)
41
- - line-by-line headline fill → `discrete-text-sequence`
42
- - accent-gradient proof number count-up → `counting-dynamic-scale`
43
- - gentle parallax / sine float on hold → `sine-wave-loop` (apply the concurrent-elements amplitude `/√N` rule for a held grid)
44
- - slow camera push-in → `multi-phase-camera` (steady-push phase pattern)
45
- - center-card scale-up + forward overlap → `spring-pop-entrance` (the quick spring) + `techniques.md` CSS-3D (z-depth overlap)
46
- - cards-grow-from-behind-icons / icon-shrink-to-header → driven by the camera reveal (`multi-phase-camera`) — the grow/shrink are scale tweens chorded to the pull-back phase; no separate rule
47
- - fixed HUD / viewfinder brackets → `ai-tracking-box` (static-bracket variant — overlay frame, not tracking)
48
- - book-end headline fade → `discrete-text-sequence` (or `gsap-effects` fade)
49
- - perpetual decorative orbit / disc / loop → `sine-wave-loop` (or `orbit-3d-entry` if it's an orbiting badge ring)
50
- - traveling-glow sweep across/behind tiles → `ambient-glow-bloom` (one-pass traveling glow sweep across the tiles)
51
- - motion-blur slide-out sweep (glass-card exit) → `motion-blur-streak` (directional velocity blur on the fast sweep that carries the cards off-frame)
52
- - grid slide-up fly-out exit → `gsap-effects` (plain staggered translate-off-frame; no dedicated rule needed — a basic exit tween, not a missing capability)
53
-
54
- **camera modifier — zoom-OUT reveal** (optional; the role-defining move for the glass-card and logo-wall variants): a camera wrapper around the whole array scales DOWN over the hold, revealing the assembled grid/cards sitting inside a larger environment (ecosystem scale, or a row of cards unfolding from tight icons).
55
-
56
- - Continuous single-pass zoom-out (Social_Proof ecosystem pull-back) → `viewport-change` (one wrapper, `cam.scale` ↓ via onUpdate — single source of truth)
57
- - Phased pull-back → focus → settle, with built-in drift (Key_Feature tight-icons → cards-unfold) → `multi-phase-camera` (use the "Dramatic reveal: push → neutral → pull" / pull-back phase pattern; grow/shrink of cards chords to the pull-back phase)
58
-
59
- ---
60
-
61
- ```
62
- BLUEPRINT: grid-card-assemble — serves Key_Feature, Benefits, Social_Proof (folded 4 drafts)
63
- RULE GAPS: none — traveling-glow sweep → ambient-glow-bloom; motion-blur slide-out sweep (exit) → motion-blur-streak; grid slide-up fly-out (exit) → gsap-effects (plain translate)
64
- ```
65
-
66
- Merge tension: `center-outward-expansion` (the natural backing for stagger-assemble) caps cleanly at 3–8 items and explicitly warns 8+ causes mid-flight overlap chaos — but a Social_Proof logo wall is deliberately dense (12+ tiles), so for that variant the items must NOT burst from a shared center; they slide a short distance directly into their own slot (the rule's "starting partially-spread"/short-path form, or a `gsap-effects` per-item stagger), which the consolidated Scene-1 verb already specifies as "short distance directly into its slot."
1
+ # grid-card-assemble — Grid / Card Assemble
2
+
3
+ **intent**: N items (tiles / cards / logos / list-lines) self-assemble in a staggered cascade into a grid or vertical list and hold — a "look how much / who / what it does" beat that enumerates breadth at once; an optional camera zoom-OUT pulls back to reveal the assembled array sitting inside a vaster whole.
4
+
5
+ **roles served**
6
+
7
+ - Key_Feature (from key-feature-card-grid-assemble): a grid of labeled feature tiles/pills (icon + label) cascades one-by-one into a 2-col-brick / 3×3 grid, then holds near-static with a slow push-in — enumerate many capabilities, no live UI, no cursor.
8
+ - Key_Feature (from key-feature-glass-card-camera-reveal): open TIGHT on 2–3 glowing icons; a camera zoom-OUT unfolds a row of glassmorphism cards that grow from behind the icons (icons shrink to card headers), center card scales forward, the group floats, then sweeps out — a "pillars revealed at once" reveal variant of the same assemble shape.
9
+ - Benefits (from benefits-vertical-list): short value phrases populate a single vertical list ~1 item/sec, co-resident and accumulating; each line enters via a spring marker-pop + check-draw + pill mask-wipe, OR the whole stack snaps up one slot per beat (slot-machine) so the newest lands in the bright focal slot.
10
+ - Social_Proof (from social-proof-logo-grid-zoom-out): a wall of partner/app logos builds into a center grid (whole-enter / randomized pop-in / column slide-up), an optional headline + accent-gradient proof-number fills in above, then a continuous camera zoom-OUT shrinks the array to reveal a vast ecosystem; optional fixed HUD/viewfinder brackets; optional grid slide-up fly-out exit.
11
+
12
+ **duration**: 3.0–10.5s (Social_Proof 3.0–6s · Key_Feature grid 5.8–7.3s · Key_Feature glass-card 6.5s · Benefits list 6.5–10.5s, scaling ~1 item/sec with count)
13
+
14
+ **shot structure** (consolidated template — concrete motion verbs, [slots])
15
+
16
+ - **Scene 1 (0.0–~1.0s) — open + first arrivals.** On a `[gradient / radial / dark background]` (optional `[dot-grid / drifting-watermark]` texture), an empty `[grid or list region]` is established and items begin to ASSEMBLE in a quick staggered cascade (~0.04–0.08s gap; list pacing ~1 item/sec). Each `[item: feature tile / pill / logo tile / benefit line]` fades + slides/scales a short distance directly into its slot (low drama — no scatter, no big bounce; spring overshoot reserved for accent markers). Camera static. An opening `[headline / hook]` may fill in line-by-line above the array, with any `[proof number]` counting up in an `[accent gradient]`.
17
+ - **Scene 2 (~1.0s–~Xs) — array resolves + holds.** Remaining items finish arriving; layout resolves into the final `[2-col-brick / 3×3 grid / dense mosaic / stacked list]`. The completed array HOLDS, alive but resting: a gentle continuous parallax/sine FLOAT on the tiles and/or a slow camera push-in (faint scale-up). Optional `[accent-color]` glow TRAVELS across/behind the tiles.
18
+ - **Scene 3 (~Xs–end) — settle / reveal / exit.** Everything settles and holds to the end, OR the optional camera modifier runs (see below), OR a `[closing line / CTA]` book-ends the array.
19
+
20
+ Variants (where roles diverge from the template):
21
+
22
+ - **Variant — Key_Feature grid**: items are labeled `[icon + feature-label]` tiles/pills assembling into a 2-col-brick / 3×3 grid; near-static hold with slow push-in + optional traveling-glow sweep; headline book-ends (`[hook]` → `[CTA]`). No camera reveal.
23
+ - **Variant — Key_Feature glass-card-reveal**: the assemble is CAMERA-DRIVEN, not element-stagger. Open tight on `[2–3 glowing icons]`; camera zoom-OUT grows `[N]` glass cards out from behind the icons (icons shrink ~50% to become card headers), `[center card]` scales ~105% and moves forward to overlap the sides (quick spring); cards hold side-by-side with continuous parallax float; exit = fast motion-blur SWEEP slides the cards off-frame.
24
+ - **Variant — Benefits vertical-list**: a single vertical `[benefit-line]` stack, ~1 item/sec, two sub-modes — (a) BUILD: each line stays fully lit; entry = `[marker]` spring-pop + `[check/icon]` draw-in + `[pill]` mask-wipe of the text; (b) SNAP: the whole stack steps up one slot per beat (~0.1s eased) so the newest line lands in the bright focal slot and lines leaving it dim by position. Static camera; optional perpetual `[decorative orbit/disc]` on the opposite side. No camera reveal.
25
+ - **Variant — Social_Proof logo-wall-zoom-out**: intro beat (`[trusted-by headline]` card OR a `[product screenshot]`) crossfades/cuts to a center logo grid that builds (whole-enter / randomized pop-in / column slide-up); a continuous camera zoom-OUT then shrinks the whole grid toward center to reveal a vast ecosystem and holds; optional fixed HUD/viewfinder brackets; optional exit = whole grid SLIDES UP and flies out through the top.
26
+
27
+ **motion vocabulary**: item stagger-assemble (fade + short slide/scale into slot) · brick/grid/list layout resolve · randomized pop-in · column slide-up · vertical-list step (slot-machine snap-and-hold) · spring-overshoot marker pop · check/icon draw-in · pill/label mask-wipe reveal · dim-by-position de-emphasis · line-by-line headline fill · accent-gradient number count-up · near-static hold · gentle parallax/sine float on hold · slow camera push-in · camera zoom-OUT reveal (continuous OR phased pull-back) · cards-grow-from-behind-icons · icon-shrink-to-header · center-card scale-up + forward overlap (spring) · traveling-glow sweep · fixed HUD/viewfinder brackets · motion-blur slide-out sweep (exit) · grid slide-up fly-out (exit) · book-end headline fade · perpetual decorative orbit/loop.
28
+
29
+ **rule mapping** (motion verb → `rule-id`)
30
+
31
+ - item stagger-assemble into slot → `center-outward-expansion` (per-item stagger + short-path slide variant; for a wall too dense for a true center burst, use it in its "starting partially-spread"/direct-into-slot form — see merge tension)
32
+ - brick/grid/list layout resolve → `center-outward-expansion` (target positions = final layout slots)
33
+ - randomized pop-in stagger → `gsap-effects` (stagger recipe; randomized `from`/order)
34
+ - column slide-up into grid → `gsap-effects` (per-column staggered slide-up)
35
+ - vertical-list step / slot-machine snap-and-hold → `vertical-spring-ticker` (STEPS = number of line advances)
36
+ - spring-overshoot marker pop → `spring-pop-entrance` (back.out spring) — also `gsap-effects` for the staggered pop chain
37
+ - check / icon draw-in inside marker → `svg-path-draw`
38
+ - live line-art icon in a tile (internal parts) → `svg-icon-enrichment`
39
+ - pill / label mask-wipe text reveal → `techniques.md` (clip-path reveal)
40
+ - dim-by-position de-emphasis → `gsap-effects` (per-line opacity by slot position; no dedicated rule)
41
+ - line-by-line headline fill → `discrete-text-sequence`
42
+ - accent-gradient proof number count-up → `counting-dynamic-scale`
43
+ - gentle parallax / sine float on hold → `sine-wave-loop` (apply the concurrent-elements amplitude `/√N` rule for a held grid)
44
+ - slow camera push-in → `multi-phase-camera` (steady-push phase pattern)
45
+ - center-card scale-up + forward overlap → `spring-pop-entrance` (the quick spring) + `techniques.md` CSS-3D (z-depth overlap)
46
+ - cards-grow-from-behind-icons / icon-shrink-to-header → driven by the camera reveal (`multi-phase-camera`) — the grow/shrink are scale tweens chorded to the pull-back phase; no separate rule
47
+ - fixed HUD / viewfinder brackets → `ai-tracking-box` (static-bracket variant — overlay frame, not tracking)
48
+ - book-end headline fade → `discrete-text-sequence` (or `gsap-effects` fade)
49
+ - perpetual decorative orbit / disc / loop → `sine-wave-loop` (or `orbit-3d-entry` if it's an orbiting badge ring)
50
+ - traveling-glow sweep across/behind tiles → `ambient-glow-bloom` (one-pass traveling glow sweep across the tiles)
51
+ - motion-blur slide-out sweep (glass-card exit) → `motion-blur-streak` (directional velocity blur on the fast sweep that carries the cards off-frame)
52
+ - grid slide-up fly-out exit → `gsap-effects` (plain staggered translate-off-frame; no dedicated rule needed — a basic exit tween, not a missing capability)
53
+
54
+ **camera modifier — zoom-OUT reveal** (optional; the role-defining move for the glass-card and logo-wall variants): a camera wrapper around the whole array scales DOWN over the hold, revealing the assembled grid/cards sitting inside a larger environment (ecosystem scale, or a row of cards unfolding from tight icons).
55
+
56
+ - Continuous single-pass zoom-out (Social_Proof ecosystem pull-back) → `viewport-change` (one wrapper, `cam.scale` ↓ via onUpdate — single source of truth)
57
+ - Phased pull-back → focus → settle, with built-in drift (Key_Feature tight-icons → cards-unfold) → `multi-phase-camera` (use the "Dramatic reveal: push → neutral → pull" / pull-back phase pattern; grow/shrink of cards chords to the pull-back phase)
58
+
59
+ ---
60
+
61
+ ```
62
+ BLUEPRINT: grid-card-assemble — serves Key_Feature, Benefits, Social_Proof (folded 4 drafts)
63
+ RULE GAPS: none — traveling-glow sweep → ambient-glow-bloom; motion-blur slide-out sweep (exit) → motion-blur-streak; grid slide-up fly-out (exit) → gsap-effects (plain translate)
64
+ ```
65
+
66
+ Merge tension: `center-outward-expansion` (the natural backing for stagger-assemble) caps cleanly at 3–8 items and explicitly warns 8+ causes mid-flight overlap chaos — but a Social_Proof logo wall is deliberately dense (12+ tiles), so for that variant the items must NOT burst from a shared center; they slide a short distance directly into their own slot (the rule's "starting partially-spread"/short-path form, or a `gsap-effects` per-item stagger), which the consolidated Scene-1 verb already specifies as "short distance directly into its slot."
@@ -1,78 +1,78 @@
1
- # kinetic-type-beats — Kinetic-Type Beats
2
-
3
- **intent**: A flat, centered, bold-type shot where the motion IS the word/phrase changing — the line either swaps tokens in place by hard cut, or builds a statement across full-screen beats (each with its own move) that lands a spring-pop payoff.
4
-
5
- **roles served**
6
-
7
- - Hook (from `hook-kinetic-type-flash`): when one stationary line lands a punchy rhetorical question or "you keep doing X" callout and the in-place token swap itself is the joke.
8
- - Hook (from `hook-kinetic-type-escalation`): when ONE statement should escalate across distinct full-screen beats (each a different move) and punctuate on a spring-pop payoff element — a rising-intensity / "transform X into Y" opener.
9
- - Problem (from `problem-kinetic-type-beats`): when the script is 3–5 short pain statements (or a "what-if?" framing) that should each land alone, on a bare canvas, before the next replaces it — no product visible yet.
10
- - Product_Intro (from `product-intro-kinetic-type-namedrop`): when the hook IS the words — hard-cut through "Introducing…" / tagline / value beats and resolve on the brand name or logo.
11
- - Benefits (from `benefits-kinetic-type`): when "what you get" is a rapid-fire staccato montage — 8–12 short value phrases, each flashing and clearing before the next at high tempo.
12
- - CTA (from `cta-kinetic-type`): when the sign-off is a punchy closing line (or a short stack of value lines) that snaps/fades in beat-by-beat and lands on the brand lockup or URL — no spatial set, no clicked button.
13
- - Brand_Outro (from `brand-outro-kinetic-type-resolve`): when the close is a rapid center-channel barrage of single-word verbs asserting breadth, resolving on the brand's one defining word (motion-is-the-message, no logo lockup).
14
-
15
- **duration**: 3.4–12s (Benefits fastest ~3.5–4s at 8–12 sub-0.5s beats; Brand_Outro ~3.6s; Problem longest 7–12s; CTA spans 3.6–11.7s with beat count)
16
-
17
- **shot structure** (flat, fixed center anchor; bold sans-serif text on a solid `[bg color]`; type/tokens are the only subject; camera locked unless a modifier is noted; two folded sub-shapes — **(A) fixed-line token swap** and **(B) multi-beat statement build**)
18
-
19
- - **Scene 1 (0.0–~1.0s) — first beat lands.** Solid `[bg color]` field. Bold `[type color]` text arrives dead-center via ONE entrance: type-on character-by-character with a trailing blinking caret, OR a hard-cut FLASH-in (no fade/slide), OR a per-word staggered fade/blur, OR an oversized word that smoothly SCALES DOWN to a small centered word. An optional `[accent color]` move plays on the key word(s): a left→right drawn underline / strike-through, a small particle/dot burst from behind the text, or a `[accent color]` selection-box framing the word.
20
- - _Variant — Hook (flash)_: just the fixed `[hook line]` (or its first word) parks at center; no escalation move.
21
- - _Variant — Hook (escalation)_: `[beat 1 text]` arrives big and scale-downs to centered, OR sits over a glowing `[motif]` with a slow camera push-in (see camera modifier); ends on a hard cut.
22
- - _Variant — Problem_: centered `[pain line 1]` reveals in chunks across one or two lines with its `[accent]` underline / particle burst.
23
- - _Variant — Product_Intro_: bold `[hook word, e.g. "Introducing"]` enters with a typographic accent (split-and-slide apart, drawn underline, or `[accent]` selection-box).
24
- - _Variant — Brand_Outro_: optional single-frame flash of `[product UI / hero asset]` precedes the verb channel, then `[verb 1]` hard-cuts in centered.
25
-
26
- - **Scene 2..N — beats replace each other in place (the engine).** The center anchor advances one beat at a time; nothing from the prior beat lingers. Choose the swap mechanism by sub-shape:
27
- - **Sub-shape A (fixed-line token swap)**: the line stays fixed and only the variable slot changes by an instant hard CUT (no roll/scroll/blur) — `[token A]` → `[token B]` → `[token C]` — OR the final word(s) backspace out and a new word retypes (`[word A]` → `[word B]`). The rest of the line holds.
28
- - **Sub-shape B (multi-beat statement build)**: each full-screen beat hard-cuts to a NEW background/line, and each gets its own distinct entrance/exit MOVE — springy scale-in/scale-out overshoot, 3D letter-tumble (glyphs scatter into a rotating depth cloud, then reassemble into the next phrase), motion-blur fly-in that resolves sharp at center, prior text accelerates/zooms past the camera while fading, letter-spacing collapse, or a bottom-up masked slide. Background may hard-flip `[bg A]`↔`[bg B]` on selected beats with `[type color]` inverting to stay legible.
29
- - _Variant — Hook (escalation)_: beat 2 `[beat 2 text]` (more emphatic) snaps in; beat 3 `[beat 3 text]` (climax) holds, then a transition-out move on the type itself — a Z-dolly forward THROUGH an oversized glyph, OR a per-word karaoke highlight sweep lighting words left→right.
30
- - _Variant — Problem_: each `[pain line k]` enters by chunk-reveal or motion-blur fly-in as the prior blurs/zooms off; an optional `[accent color]` interstitial word ("[what-if hook]") scales up from center, holds, then zooms past the camera and fades.
31
- - _Variant — Product_Intro_: each `[tagline phrase]` is a hard-cut/push-through inverted-text beat with its own one-shot accent (strike-through, slider/toggle shapes sliding in, or a bg-invert cycle white→`[accent]`→black flipping fg/bg).
32
- - _Variant — Benefits_: high tempo (~0.4s/beat) — each `[benefit phrase]` pops via springy scale-in/out or 3D letter-tumble; multiple bg light↔dark flips across the run with text-color invert.
33
- - _Variant — CTA_: each `[value line]` → `[value line]` → `[CTA verb line]` clears by hard cut / zoom-blur cut through near-black / fade-out, then the next pops/fades/slides in. Optional `[accent motif]` draws on behind (rising line-graph trim-path, thin wireframe guides, gutter geometry tiles).
34
- - _Variant — Brand_Outro_: a centered single `[verb / keyword]` HARD-CUTS to the next at a steady ~0.2s cadence (no fade/scale) over a continuous moving field (see camera modifier).
35
-
36
- - **Scene N (final beat → end) — resolve and HOLD.** The last beat lands and holds to the end (settle only, no further scale-out). Resolution diverges by role:
37
- - _Variant — Hook (flash)_: last token swap lands and holds; optional tiny punctuation/emphasis snap (`?` → `?!`, or fill snaps to `[accent color]`).
38
- - _Variant — Hook (escalation)_: resolve on `[payoff bg]` — a `[payoff element]` (colored square / heart-eyes reaction emoji) SPRING-POPS in center; small `[accent motes]` drift outward; subtle settle.
39
- - _Variant — Problem_: final `[pain line]` reveals (left→right swipe with leading-edge blur, OR letters explode radially then the resolving line fades up); holds the pain on screen.
40
- - _Variant — Product_Intro_: resolve on the brand — `[logo mark]` / `[wordmark]` pops in centered (optional sting: liquid/ink splash, blob backing), OR the final value word holds inside an expanding-iris `[accent]` circle that scales to fill frame and hard-cuts the closing word through it.
41
- - _Variant — Benefits_: the last `[benefit phrase]` arrives (optionally on the inverted bg) and SETTLES — does not scale/tumble back out.
42
- - _Variant — CTA_: land on the lockup — `[logo mark]` SCALES UP small→full and holds, OR a `[logo]`/`[url]` builds segment-by-segment beside its icon. End-card holds dead static.
43
- - _Variant — Brand_Outro_: hard cut to the `[resolve word / brand keyword]` (longest, still centered); HOLDS ~0.5s while the background field keeps moving.
44
-
45
- **motion vocabulary**: hard-cut / flash word swaps; in-place token cycle (instant cut, no roll/scroll/blur); type-on with trailing blinking caret; backspace-and-retype; per-word staggered fade/blur reveal; big→small scale-down; springy scale-in/scale-out overshoot; 3D letter-tumble scatter-and-reassemble; motion-blur fly-in / blur-off; prior text zoom-through-camera; letter-spacing collapse; bottom-up masked slide; drawn-on `[accent]` underline / strike-through; particle/dot burst from text; `[accent]` selection-box frame; bg-invert hard-flip with text-color invert; karaoke per-word highlight sweep; radial letter-explode; expanding-iris circle wipe-to-next; final spring-pop payoff element (square / emoji / logo mark); drifting `[accent]` motes / ambient shapes; segment-by-segment URL/wordmark build; final-token punctuation snap; settle-and-hold.
46
-
47
- **rule mapping**
48
-
49
- - hard-cut / flash word swaps, in-place token cycle, whole-line state swaps at time thresholds → `discrete-text-sequence`
50
- - type-on character-by-character + blinking trailing caret → `discrete-text-sequence` (text/typing state progression) + `context-sensitive-cursor` (caret blink/color-switch)
51
- - backspace-and-retype final word(s) → `discrete-text-sequence` (typos/holds/backspace is explicitly in-scope)
52
- - one short distinct phrase per beat / script-driven phrase windows / word-by-word tagline assembly → `dynamic-content-sequencing`
53
- - percussive per-beat phrase entrances on a shared beat array (distinct entrance per phrase, steady cadence) → `kinetic-beat-slam` (best fit for the multi-beat statement-build engine and the ~0.2s Brand_Outro verb march)
54
- - per-word staggered fade/blur reveal → `kinetic-beat-slam` (per-phrase/per-word distinct entrances); the soft-focus blur component → `depth-of-field-blur` (selective-focus blur on the off-focus words)
55
- - big→small scale-down on a word; springy scale-in/scale-out overshoot → `spring-pop-entrance` (spring pop/settle) backed by `gsap-effects` for the plain scale tween
56
- - 3D letter-tumble scatter-into-depth-cloud then reassemble → `depth-scatter-assemble` (glyphs scatter into a 3D depth cloud and reassemble into the next phrase; combine w/ `3d-text-depth-layers` for the extruded read, or `hacker-flip-3d` for an in-place per-char flip flavor)
57
- - karaoke per-word highlight sweep synced across words → `asr-keyword-glow` (keyword glow+scale on a synced rail) OR `css-marker-patterns` (highlight sweep) — choose ASR-driven vs. static-timeline sweep
58
- - drawn-on `[accent]` underline / strike-through / loop / scribble under key word → `css-marker-patterns` (highlight sweep / circle / burst / scribble / sketchout)
59
- - particle/dot burst from behind text → `css-marker-patterns` (burst) backed by `gsap-effects`
60
- - `[accent]` selection-box frame around a word → `css-marker-patterns` (circle/box marker) + `gsap-effects`
61
- - bg-invert hard-flip (light↔dark / white→accent→black) with text-color invert → `discrete-text-sequence` (whole-text/state swap covers the synchronized fg/bg state change)
62
- - letter-spacing collapse; bottom-up masked slide → `gsap-effects` (tween letter-spacing / masked translate) + techniques: per-word kinetic typography / clip-path reveal
63
- - expanding-iris circle wipe that morphs the current word into the next at the same center → `scale-swap-transition` (morph two elements at same center)
64
- - final spring-pop payoff element (colored square / reaction emoji / logo mark) → `spring-pop-entrance` (or `physics-press-reaction` for a weightier pop)
65
- - drifting `[accent]` motes / ambient shapes / soft drifting gradient field beneath the type → `sine-wave-loop` (idle drift loop)
66
- - segment-by-segment URL / wordmark build beside its icon → `discrete-text-sequence` (segment-by-segment state reveal) or `dynamic-content-sequencing`
67
- - final-token punctuation / emphasis snap (`?`→`?!`, fill→accent) → `discrete-text-sequence`
68
- - settle-and-hold final frame → `spring-pop-entrance` (settle phase) / static hold (no rule needed)
69
- - motion-blur fly-in / blur-off / zoom-through-camera streak on type → `motion-blur-streak` (directional velocity blur on a fast fly-in / zoom-through; the heavy motion-blur smear resolves sharp at center)
70
- - radial letter-explode (glyphs explode outward radially then resolve) → `depth-scatter-assemble` (radial per-letter explode-and-resolve is in scope alongside the depth-cloud scatter)
71
- - 3D letter-tumble depth-cloud scatter-and-reassemble → `depth-scatter-assemble` (free tumbling depth-cloud that flies out and snaps back into the next phrase)
72
-
73
- **camera modifier** (optional, layered over the flat shot; most variants are camera-locked)
74
-
75
- - Slow continuous global zoom-in / uniform push-in running underneath the whole sequence (Problem, Brand_Outro) → `multi-phase-camera` (push phase) — gives parallax between the fixed type and a moving background field.
76
- - Camera dolly/zoom forward THROUGH an oversized glyph along Z as a beat transition-out (Hook escalation, Product_Intro push-through) → `coordinate-target-zoom` (target the glyph center) or `multi-phase-camera` (push).
77
- - Slow push-in on Scene 1 over a glowing `[motif]` (Hook escalation) → `multi-phase-camera` (push) or `coordinate-target-zoom`.
78
- - Note: the in-place token swap (sub-shape A) and most Benefits/Hook-flash/CTA variants are fully camera-static — the swap is the only motion.
1
+ # kinetic-type-beats — Kinetic-Type Beats
2
+
3
+ **intent**: A flat, centered, bold-type shot where the motion IS the word/phrase changing — the line either swaps tokens in place by hard cut, or builds a statement across full-screen beats (each with its own move) that lands a spring-pop payoff.
4
+
5
+ **roles served**
6
+
7
+ - Hook (from `hook-kinetic-type-flash`): when one stationary line lands a punchy rhetorical question or "you keep doing X" callout and the in-place token swap itself is the joke.
8
+ - Hook (from `hook-kinetic-type-escalation`): when ONE statement should escalate across distinct full-screen beats (each a different move) and punctuate on a spring-pop payoff element — a rising-intensity / "transform X into Y" opener.
9
+ - Problem (from `problem-kinetic-type-beats`): when the script is 3–5 short pain statements (or a "what-if?" framing) that should each land alone, on a bare canvas, before the next replaces it — no product visible yet.
10
+ - Product_Intro (from `product-intro-kinetic-type-namedrop`): when the hook IS the words — hard-cut through "Introducing…" / tagline / value beats and resolve on the brand name or logo.
11
+ - Benefits (from `benefits-kinetic-type`): when "what you get" is a rapid-fire staccato montage — 8–12 short value phrases, each flashing and clearing before the next at high tempo.
12
+ - CTA (from `cta-kinetic-type`): when the sign-off is a punchy closing line (or a short stack of value lines) that snaps/fades in beat-by-beat and lands on the brand lockup or URL — no spatial set, no clicked button.
13
+ - Brand_Outro (from `brand-outro-kinetic-type-resolve`): when the close is a rapid center-channel barrage of single-word verbs asserting breadth, resolving on the brand's one defining word (motion-is-the-message, no logo lockup).
14
+
15
+ **duration**: 3.4–12s (Benefits fastest ~3.5–4s at 8–12 sub-0.5s beats; Brand_Outro ~3.6s; Problem longest 7–12s; CTA spans 3.6–11.7s with beat count)
16
+
17
+ **shot structure** (flat, fixed center anchor; bold sans-serif text on a solid `[bg color]`; type/tokens are the only subject; camera locked unless a modifier is noted; two folded sub-shapes — **(A) fixed-line token swap** and **(B) multi-beat statement build**)
18
+
19
+ - **Scene 1 (0.0–~1.0s) — first beat lands.** Solid `[bg color]` field. Bold `[type color]` text arrives dead-center via ONE entrance: type-on character-by-character with a trailing blinking caret, OR a hard-cut FLASH-in (no fade/slide), OR a per-word staggered fade/blur, OR an oversized word that smoothly SCALES DOWN to a small centered word. An optional `[accent color]` move plays on the key word(s): a left→right drawn underline / strike-through, a small particle/dot burst from behind the text, or a `[accent color]` selection-box framing the word.
20
+ - _Variant — Hook (flash)_: just the fixed `[hook line]` (or its first word) parks at center; no escalation move.
21
+ - _Variant — Hook (escalation)_: `[beat 1 text]` arrives big and scale-downs to centered, OR sits over a glowing `[motif]` with a slow camera push-in (see camera modifier); ends on a hard cut.
22
+ - _Variant — Problem_: centered `[pain line 1]` reveals in chunks across one or two lines with its `[accent]` underline / particle burst.
23
+ - _Variant — Product_Intro_: bold `[hook word, e.g. "Introducing"]` enters with a typographic accent (split-and-slide apart, drawn underline, or `[accent]` selection-box).
24
+ - _Variant — Brand_Outro_: optional single-frame flash of `[product UI / hero asset]` precedes the verb channel, then `[verb 1]` hard-cuts in centered.
25
+
26
+ - **Scene 2..N — beats replace each other in place (the engine).** The center anchor advances one beat at a time; nothing from the prior beat lingers. Choose the swap mechanism by sub-shape:
27
+ - **Sub-shape A (fixed-line token swap)**: the line stays fixed and only the variable slot changes by an instant hard CUT (no roll/scroll/blur) — `[token A]` → `[token B]` → `[token C]` — OR the final word(s) backspace out and a new word retypes (`[word A]` → `[word B]`). The rest of the line holds.
28
+ - **Sub-shape B (multi-beat statement build)**: each full-screen beat hard-cuts to a NEW background/line, and each gets its own distinct entrance/exit MOVE — springy scale-in/scale-out overshoot, 3D letter-tumble (glyphs scatter into a rotating depth cloud, then reassemble into the next phrase), motion-blur fly-in that resolves sharp at center, prior text accelerates/zooms past the camera while fading, letter-spacing collapse, or a bottom-up masked slide. Background may hard-flip `[bg A]`↔`[bg B]` on selected beats with `[type color]` inverting to stay legible.
29
+ - _Variant — Hook (escalation)_: beat 2 `[beat 2 text]` (more emphatic) snaps in; beat 3 `[beat 3 text]` (climax) holds, then a transition-out move on the type itself — a Z-dolly forward THROUGH an oversized glyph, OR a per-word karaoke highlight sweep lighting words left→right.
30
+ - _Variant — Problem_: each `[pain line k]` enters by chunk-reveal or motion-blur fly-in as the prior blurs/zooms off; an optional `[accent color]` interstitial word ("[what-if hook]") scales up from center, holds, then zooms past the camera and fades.
31
+ - _Variant — Product_Intro_: each `[tagline phrase]` is a hard-cut/push-through inverted-text beat with its own one-shot accent (strike-through, slider/toggle shapes sliding in, or a bg-invert cycle white→`[accent]`→black flipping fg/bg).
32
+ - _Variant — Benefits_: high tempo (~0.4s/beat) — each `[benefit phrase]` pops via springy scale-in/out or 3D letter-tumble; multiple bg light↔dark flips across the run with text-color invert.
33
+ - _Variant — CTA_: each `[value line]` → `[value line]` → `[CTA verb line]` clears by hard cut / zoom-blur cut through near-black / fade-out, then the next pops/fades/slides in. Optional `[accent motif]` draws on behind (rising line-graph trim-path, thin wireframe guides, gutter geometry tiles).
34
+ - _Variant — Brand_Outro_: a centered single `[verb / keyword]` HARD-CUTS to the next at a steady ~0.2s cadence (no fade/scale) over a continuous moving field (see camera modifier).
35
+
36
+ - **Scene N (final beat → end) — resolve and HOLD.** The last beat lands and holds to the end (settle only, no further scale-out). Resolution diverges by role:
37
+ - _Variant — Hook (flash)_: last token swap lands and holds; optional tiny punctuation/emphasis snap (`?` → `?!`, or fill snaps to `[accent color]`).
38
+ - _Variant — Hook (escalation)_: resolve on `[payoff bg]` — a `[payoff element]` (colored square / heart-eyes reaction emoji) SPRING-POPS in center; small `[accent motes]` drift outward; subtle settle.
39
+ - _Variant — Problem_: final `[pain line]` reveals (left→right swipe with leading-edge blur, OR letters explode radially then the resolving line fades up); holds the pain on screen.
40
+ - _Variant — Product_Intro_: resolve on the brand — `[logo mark]` / `[wordmark]` pops in centered (optional sting: liquid/ink splash, blob backing), OR the final value word holds inside an expanding-iris `[accent]` circle that scales to fill frame and hard-cuts the closing word through it.
41
+ - _Variant — Benefits_: the last `[benefit phrase]` arrives (optionally on the inverted bg) and SETTLES — does not scale/tumble back out.
42
+ - _Variant — CTA_: land on the lockup — `[logo mark]` SCALES UP small→full and holds, OR a `[logo]`/`[url]` builds segment-by-segment beside its icon. End-card holds dead static.
43
+ - _Variant — Brand_Outro_: hard cut to the `[resolve word / brand keyword]` (longest, still centered); HOLDS ~0.5s while the background field keeps moving.
44
+
45
+ **motion vocabulary**: hard-cut / flash word swaps; in-place token cycle (instant cut, no roll/scroll/blur); type-on with trailing blinking caret; backspace-and-retype; per-word staggered fade/blur reveal; big→small scale-down; springy scale-in/scale-out overshoot; 3D letter-tumble scatter-and-reassemble; motion-blur fly-in / blur-off; prior text zoom-through-camera; letter-spacing collapse; bottom-up masked slide; drawn-on `[accent]` underline / strike-through; particle/dot burst from text; `[accent]` selection-box frame; bg-invert hard-flip with text-color invert; karaoke per-word highlight sweep; radial letter-explode; expanding-iris circle wipe-to-next; final spring-pop payoff element (square / emoji / logo mark); drifting `[accent]` motes / ambient shapes; segment-by-segment URL/wordmark build; final-token punctuation snap; settle-and-hold.
46
+
47
+ **rule mapping**
48
+
49
+ - hard-cut / flash word swaps, in-place token cycle, whole-line state swaps at time thresholds → `discrete-text-sequence`
50
+ - type-on character-by-character + blinking trailing caret → `discrete-text-sequence` (text/typing state progression) + `context-sensitive-cursor` (caret blink/color-switch)
51
+ - backspace-and-retype final word(s) → `discrete-text-sequence` (typos/holds/backspace is explicitly in-scope)
52
+ - one short distinct phrase per beat / script-driven phrase windows / word-by-word tagline assembly → `dynamic-content-sequencing`
53
+ - percussive per-beat phrase entrances on a shared beat array (distinct entrance per phrase, steady cadence) → `kinetic-beat-slam` (best fit for the multi-beat statement-build engine and the ~0.2s Brand_Outro verb march)
54
+ - per-word staggered fade/blur reveal → `kinetic-beat-slam` (per-phrase/per-word distinct entrances); the soft-focus blur component → `depth-of-field-blur` (selective-focus blur on the off-focus words)
55
+ - big→small scale-down on a word; springy scale-in/scale-out overshoot → `spring-pop-entrance` (spring pop/settle) backed by `gsap-effects` for the plain scale tween
56
+ - 3D letter-tumble scatter-into-depth-cloud then reassemble → `depth-scatter-assemble` (glyphs scatter into a 3D depth cloud and reassemble into the next phrase; combine w/ `3d-text-depth-layers` for the extruded read, or `hacker-flip-3d` for an in-place per-char flip flavor)
57
+ - karaoke per-word highlight sweep synced across words → `asr-keyword-glow` (keyword glow+scale on a synced rail) OR `css-marker-patterns` (highlight sweep) — choose ASR-driven vs. static-timeline sweep
58
+ - drawn-on `[accent]` underline / strike-through / loop / scribble under key word → `css-marker-patterns` (highlight sweep / circle / burst / scribble / sketchout)
59
+ - particle/dot burst from behind text → `css-marker-patterns` (burst) backed by `gsap-effects`
60
+ - `[accent]` selection-box frame around a word → `css-marker-patterns` (circle/box marker) + `gsap-effects`
61
+ - bg-invert hard-flip (light↔dark / white→accent→black) with text-color invert → `discrete-text-sequence` (whole-text/state swap covers the synchronized fg/bg state change)
62
+ - letter-spacing collapse; bottom-up masked slide → `gsap-effects` (tween letter-spacing / masked translate) + techniques: per-word kinetic typography / clip-path reveal
63
+ - expanding-iris circle wipe that morphs the current word into the next at the same center → `scale-swap-transition` (morph two elements at same center)
64
+ - final spring-pop payoff element (colored square / reaction emoji / logo mark) → `spring-pop-entrance` (or `physics-press-reaction` for a weightier pop)
65
+ - drifting `[accent]` motes / ambient shapes / soft drifting gradient field beneath the type → `sine-wave-loop` (idle drift loop)
66
+ - segment-by-segment URL / wordmark build beside its icon → `discrete-text-sequence` (segment-by-segment state reveal) or `dynamic-content-sequencing`
67
+ - final-token punctuation / emphasis snap (`?`→`?!`, fill→accent) → `discrete-text-sequence`
68
+ - settle-and-hold final frame → `spring-pop-entrance` (settle phase) / static hold (no rule needed)
69
+ - motion-blur fly-in / blur-off / zoom-through-camera streak on type → `motion-blur-streak` (directional velocity blur on a fast fly-in / zoom-through; the heavy motion-blur smear resolves sharp at center)
70
+ - radial letter-explode (glyphs explode outward radially then resolve) → `depth-scatter-assemble` (radial per-letter explode-and-resolve is in scope alongside the depth-cloud scatter)
71
+ - 3D letter-tumble depth-cloud scatter-and-reassemble → `depth-scatter-assemble` (free tumbling depth-cloud that flies out and snaps back into the next phrase)
72
+
73
+ **camera modifier** (optional, layered over the flat shot; most variants are camera-locked)
74
+
75
+ - Slow continuous global zoom-in / uniform push-in running underneath the whole sequence (Problem, Brand_Outro) → `multi-phase-camera` (push phase) — gives parallax between the fixed type and a moving background field.
76
+ - Camera dolly/zoom forward THROUGH an oversized glyph along Z as a beat transition-out (Hook escalation, Product_Intro push-through) → `coordinate-target-zoom` (target the glyph center) or `multi-phase-camera` (push).
77
+ - Slow push-in on Scene 1 over a glowing `[motif]` (Hook escalation) → `multi-phase-camera` (push) or `coordinate-target-zoom`.
78
+ - Note: the in-place token swap (sub-shape A) and most Benefits/Hook-flash/CTA variants are fully camera-static — the swap is the only motion.
@@ -1,69 +1,69 @@
1
- # logo-assemble-lockup — Logo Assemble → Lockup
2
-
3
- **intent**: A brand mark / wordmark builds itself from parts (elements assemble or orbit in, letters cascade, an outline draws on, or a camera pushes through negative space) and resolves into a centered logo lockup — optionally extended into a final URL / CTA.
4
-
5
- **roles served**
6
-
7
- - Product_Intro (from product-intro-logo-system-assemble): A wordless, premium brand STING — an abstract system of elements pulses / grows / orbits and assembles around a FIXED central logo, carried by one cinematic camera tilt; no copy, no UI.
8
- - CTA (from cta-camera-push-lockup): The logo build is a LEAD-IN to the final ask — a 3D mark assembles + wordmark cascades, then a fast camera PUSH-THROUGH the mark's negative space streaks giant CTA letters past the lens and resolves on a `[url]` / `[CTA verb]` lockup.
9
- - CTA (from cta-button-wordmark-build): The "draws-its-own-outline → wordmark-builds-letter-by-letter" sub-shape — a `[CTA button]` pill strokes its own glowing border, a diagonal-band WIPE flips the frame, and the `[wordmark]` types in beside a slash to land the lockup. Camera static.
10
- - Brand_Outro (from brand-outro-assemble-logo-lockup): The closing mark — a formation of `[feature pills / UI elements]` CLEARS the stage off all four edges, then on the empty frame the `[logo mark]` draws itself on stroke-by-stroke and the `[wordmark]` reveals to complete the lockup, then fades out.
11
- - Product_Intro (from brand-reveal-assemble-zoom): a context-then-focus reveal — a companion tagline TYPES out to set context, the hero mark pops in beside it, then the companion exits as the layout recenters and the camera pushes IN to a held close-up on the mark (wide composition narrowing to a tight focus).
12
-
13
- **duration**: ~4.6–11.0s (Brand_Outro ~4.6s · brand-reveal ~5s · Product_Intro ~7s · CTA 5.4–11.0s)
14
-
15
- **shot structure** (one consolidated time-coded template; `[slots]` are product-agnostic)
16
-
17
- - Scene 1 — clear / ignite (0.0–~1.0s): the stage is prepared for the mark to build into.
18
- - _Variant — Product_Intro_: opens on a clean `[light bg]` with faint concentric guide rings under a flat top-down view; rings PULSE and expand from center; mid-beat the bg crossfades `[light]→[dark gradient: hero→secondary]`, tiny seed dots appear along the rings, and the central `[logo mark]`'s glow IGNITES (mark is present from t=0, fixed, front-facing).
19
- - _Variant — CTA push_: on a `[bg gradient]`, the `[logo mark]` is settling in object space (a 3D mark with thin wireframe edge-guides + a faint bracket motif behind center); a very slow continuous camera push-in may already be creeping.
20
- - _Variant — CTA button-build_: on a `[dark grid bg]`, a rounded `[CTA button "label"]` pill rises / scales into center (a prior headline clearing off the top); its thin border DRAWS ON as an animated glowing outline STROKE, with a small `[accent]` comet / spark icon at its left edge.
21
- - _Variant — Brand_Outro_: a PRE-ARRANGED formation of `[feature pills / element grid]` (each `[icon]`+`[label]`) DISPERSES — elements slide outward from their laid-out positions and fly off all four frame edges (edge-clearing drift, NOT a center-origin burst), emptying the frame onto a clean `[bg]`.
22
-
23
- - Scene 2 — assemble the mark (~1.0–~Ys): the mark builds itself from parts.
24
- - _Variant — Product_Intro_: seed dots SCALE UP into flat `[accent]` shapes arranged on the rings; concentric bands ripple outward (tunneling feel) and the shapes begin to ORBIT / drift around the still-fixed center.
25
- - _Variant — CTA push_: the `[wordmark]` CASCADES out from behind the mark (letters left→right with overshoot) into the full `[brand lockup]`; the 3D mark may assemble in beats (a terminal detaches + pops as a spring dot, a part hinges-open-and-snaps-shut elastic). Optional beat: a `[cursor]` arcs in and "clicks" the wordmark, OR a frosted-glass pill holding an intermediate `[CTA line]` springs in while layered mark shells fan to the edges.
26
- - _Variant — CTA button-build_: a graphic WIPE flips the frame to `[contrast bg]` — a thin `[accent]` diagonal line sweeps in, swells into a full-frame diagonal BAND, then collapses to a small `[accent]` slash.
27
- - _Variant — Brand_Outro_: on the now-clear frame, the `[logo mark]` DRAWS ON via stroke (built arc-by-arc / segment-by-segment).
28
-
29
- - Scene 3 — resolve to lockup (~Ys–end): the lockup completes and holds (Product_Intro / Brand_Outro) or is flown into / extended to a CTA (CTA variants).
30
- - _Variant — Product_Intro (the ONE camera move)_: the whole system smoothly TILTS from flat top-down into an angled isometric perspective (ease-in-out) with a slight zoom-out — flat shapes become luminous 3D forms, bands become glowing orbit lines, while the central `[logo mark]` does NOT tilt (stays 2D, front-facing, fixed). Camera eases to a stop; elements keep continuous orbit/drift (inner faster than outer); the mark holds its steady glow. Final settled frame.
31
- - _Variant — CTA push (the signature)_: a single fast CAMERA PUSH-THROUGH the mark's negative space / through the glass pill — heavy horizontal motion-blur, giant `[CTA]` letters streaking past the lens (cursor drops out). Resolves to the final lockup on a saturated `[bg]`: a `[url badge]` / `[CTA line]` revealed by a left→right WIPE carrying an `[accent]` leading edge (or a clean fade), with solid mark-shapes parallax-sliding in behind. Settles to a dead-static hold (slow zoom-out / settle).
32
- - _Variant — CTA button-build_: the `[wordmark]` BUILDS letter-by-letter to the right of the slash, landing on the final "`[slash] [WORDMARK]`" lockup centered on the new bg. Slow settle to static.
33
- - _Variant — Brand_Outro_: the `[wordmark]` reveals beside the drawn mark (slide / fade) to complete the `[lockup]`; the lockup holds, then fades to `[black / bg]`.
34
-
35
- **motion vocabulary**: ring pulse / expand; background crossfade (light→dark); glow ignite; seed-dot scale-up; continuous orbit / drift (inner faster than outer); single 3D perspective tilt (flat→isometric) + slight zoom-out around a fixed 2D anchor; 3D logo assemble (part detach + spring dot, clapperboard hinge / snap, shell fan-out); wordmark cascade with overshoot (letters left→right); button pill rise / scale-in; animated stroke-outline DRAW + glow (button border AND logo mark); comet / spark accent; diagonal-band wipe (sweep → swell → collapse-to-slash); letter-by-letter wordmark build; pre-formed grid DISPERSE off all four edges; logo-mark stroke-draw (sequential arcs / segments); fast CAMERA PUSH-THROUGH with motion-blur (CTA spine); continuous slow push-in / push-out; cursor arc-in + click; parallax shape slide-in; left→right URL/badge wipe with glowing leading edge; static / fade-out end-lockup hold; optional idle breathe on the held mark.
36
-
37
- **rule mapping** (per motion verb → `rules/<id>.md`)
38
-
39
- - ring pulse / expand from center → `center-outward-expansion` (radiate from a shared center; reuse the 0→1 progress driver)
40
- - background crossfade (light→dark gradient) → plain opacity/background tween via `gsap-effects` (no dedicated rule needed)
41
- - glow ignite on the mark → `asr-keyword-glow` (envelope-driven glow on the brand element)
42
- - seed-dot scale-up into shapes → `spring-pop-entrance` (scale-in pop; alt `scale-swap-transition` if dots morph into shapes)
43
- - continuous orbit / drift around fixed center → `orbit-3d-entry` (flip-in then continuous elliptical orbit; center label = the fixed mark)
44
- - single 3D perspective tilt (flat→isometric) + slight zoom-out → `multi-phase-camera` (scripted scale phases on a scene-wrapping camera, for the zoom-out) — see camera modifier; the FLAT→ISOMETRIC plane tilt of the whole stage is a CSS-3D perspective move (`techniques.md` CSS-3D, animating the stage's `rotateX`) — no exact camera rule for the plane-tilt, approximate via CSS-3D (closest reference is `orbit-3d-entry`'s "Tilted orbit plane" variation animated over time)
45
- - fixed 2D anchor logo amid moving universe → no motion rule needed (static anchor; intentional — it's the absence of motion, the universe moves around it)
46
- - 3D logo assemble — part detach + spring dot → `spring-pop-entrance` (spring pop, `back.out` overshoot)
47
- - 3D logo assemble — hinge open / snap (clapperboard) → `hacker-flip-3d` (the 3D-rotate axis) + `techniques.md` CSS-3D (the elastic open-and-snap-shut hinge is an adaptation of the 3D-rotate)
48
- - 3D logo assemble — shell fan-out to edges → `center-outward-expansion` (run outward from the mark center)
49
- - wordmark cascade with overshoot (letters left→right) → recipe `gsap-effects` (per-element staggered slide) + `spring-pop-entrance` (the `back.out` overshoot per letter)
50
- - button pill rise / scale-in → `spring-pop-entrance` (scale-in; alt `scale-swap-transition`)
51
- - animated stroke-outline draw + glow (button border) → `svg-path-draw` (stroke-dashoffset draw) + `asr-keyword-glow` (the glow on the drawn stroke)
52
- - comet / spark accent on button → `asr-keyword-glow` (small glow accent); motion path via `techniques.md` GSAP MotionPathPlugin (#9)
53
- - diagonal-band wipe (sweep → swell → collapse-to-slash) → `techniques.md` clip-path reveal (#12, animate a `polygon(...)` diagonal across the frame; the swell-then-collapse-to-slash is the same clip-path reveal driven through grow→shrink keyframes)
54
- - letter-by-letter wordmark build → `discrete-text-sequence` (smooth-slice / per-state build); recipe `gsap-effects` (typewriter / appending words)
55
- - pre-formed grid disperse off all four edges → not a rule gap: a formation flying off-frame is an EXIT, and the pipeline forbids mid-video exits — the harness transition IS the exit (only the final frame may exit the stage). Treat this as transition-handled / final-frame-only rather than an in-scene motion rule. (If staged in-scene as a reveal-the-mark clear, it reuses `center-outward-expansion` run OUTWARD — center→target machinery interpolating formation→offscreen targets, out-easing.)
56
- - logo-mark stroke-draw (sequential arcs / segments) → `svg-path-draw` (the canonical multi-segment stagger draw)
57
- - wordmark slide / fade reveal beside drawn mark → `svg-path-draw` (its "brand-line fades in after stroke" tail) ; slide via `spring-pop-entrance`
58
- - fast camera push-through with motion-blur → `multi-phase-camera` (a hard push phase) — see camera modifier; the heavy motion-blur streak itself → `motion-blur-streak` (directional velocity blur on the fast push-through)
59
- - continuous slow push-in / push-out → `multi-phase-camera` (phase scale + drift)
60
- - cursor arc-in + click on the wordmark → `cursor-click-ripple` (move → click → ripple); arc path via `techniques.md` MotionPathPlugin (#9)
61
- - parallax shape slide-in behind lockup → `depth-scatter-assemble` (parallax depth slide-in of shapes at differing depths; pair with `3d-text-depth-layers` for the depth ordering)
62
- - left→right URL / badge wipe with glowing leading edge → `techniques.md` clip-path reveal (#12, animate `inset()` left→right); the glowing leading edge → `asr-keyword-glow`
63
- - static / fade-out end-lockup hold → no motion rule needed (terminal hold / opacity fade; intentional)
64
- - idle breathe on held mark (optional) → `sine-wave-loop` (post-settle breathing)
65
-
66
- **camera modifier** (the push / tilt)
67
-
68
- - **CTA push-through** (the CTA spine): a scripted hard zoom phase on a scene-wrapping camera → `multi-phase-camera` ("Steady push" / "Bookend pull" pattern; push phase = the climax). When the mark is OFF-center and the camera must fly through a specific point of negative space, combine with `coordinate-target-zoom` (outer scales, inner counter-translates so the target negative-space point lands at viewport center as scale ramps; measure the offset at setup). The signature heavy horizontal MOTION-BLUR on the streak → `motion-blur-streak` (directional velocity blur on the push); realize with a CSS `filter: blur()` / duplicated-streak layer on the camera during the push window.
69
- - **Product_Intro tilt** (the one cinematic move): the flat→isometric perspective tilt + slight zoom-out is a single scripted camera beat → `multi-phase-camera` (scale phase + the "Targeted zoom into off-center element" / drift machinery) for the zoom-out. `multi-phase-camera` is scale+translate+drift only, so the perspective-PLANE rotateX (flat top-down → angled isometric) of the whole stage is the CSS-3D move noted above — approximate via `techniques.md` CSS-3D, animating the stage's `rotateX` (closest reference is `orbit-3d-entry`'s "Tilted orbit plane" variation animated over time).
1
+ # logo-assemble-lockup — Logo Assemble → Lockup
2
+
3
+ **intent**: A brand mark / wordmark builds itself from parts (elements assemble or orbit in, letters cascade, an outline draws on, or a camera pushes through negative space) and resolves into a centered logo lockup — optionally extended into a final URL / CTA.
4
+
5
+ **roles served**
6
+
7
+ - Product_Intro (from product-intro-logo-system-assemble): A wordless, premium brand STING — an abstract system of elements pulses / grows / orbits and assembles around a FIXED central logo, carried by one cinematic camera tilt; no copy, no UI.
8
+ - CTA (from cta-camera-push-lockup): The logo build is a LEAD-IN to the final ask — a 3D mark assembles + wordmark cascades, then a fast camera PUSH-THROUGH the mark's negative space streaks giant CTA letters past the lens and resolves on a `[url]` / `[CTA verb]` lockup.
9
+ - CTA (from cta-button-wordmark-build): The "draws-its-own-outline → wordmark-builds-letter-by-letter" sub-shape — a `[CTA button]` pill strokes its own glowing border, a diagonal-band WIPE flips the frame, and the `[wordmark]` types in beside a slash to land the lockup. Camera static.
10
+ - Brand_Outro (from brand-outro-assemble-logo-lockup): The closing mark — a formation of `[feature pills / UI elements]` CLEARS the stage off all four edges, then on the empty frame the `[logo mark]` draws itself on stroke-by-stroke and the `[wordmark]` reveals to complete the lockup, then fades out.
11
+ - Product_Intro (from brand-reveal-assemble-zoom): a context-then-focus reveal — a companion tagline TYPES out to set context, the hero mark pops in beside it, then the companion exits as the layout recenters and the camera pushes IN to a held close-up on the mark (wide composition narrowing to a tight focus).
12
+
13
+ **duration**: ~4.6–11.0s (Brand_Outro ~4.6s · brand-reveal ~5s · Product_Intro ~7s · CTA 5.4–11.0s)
14
+
15
+ **shot structure** (one consolidated time-coded template; `[slots]` are product-agnostic)
16
+
17
+ - Scene 1 — clear / ignite (0.0–~1.0s): the stage is prepared for the mark to build into.
18
+ - _Variant — Product_Intro_: opens on a clean `[light bg]` with faint concentric guide rings under a flat top-down view; rings PULSE and expand from center; mid-beat the bg crossfades `[light]→[dark gradient: hero→secondary]`, tiny seed dots appear along the rings, and the central `[logo mark]`'s glow IGNITES (mark is present from t=0, fixed, front-facing).
19
+ - _Variant — CTA push_: on a `[bg gradient]`, the `[logo mark]` is settling in object space (a 3D mark with thin wireframe edge-guides + a faint bracket motif behind center); a very slow continuous camera push-in may already be creeping.
20
+ - _Variant — CTA button-build_: on a `[dark grid bg]`, a rounded `[CTA button "label"]` pill rises / scales into center (a prior headline clearing off the top); its thin border DRAWS ON as an animated glowing outline STROKE, with a small `[accent]` comet / spark icon at its left edge.
21
+ - _Variant — Brand_Outro_: a PRE-ARRANGED formation of `[feature pills / element grid]` (each `[icon]`+`[label]`) DISPERSES — elements slide outward from their laid-out positions and fly off all four frame edges (edge-clearing drift, NOT a center-origin burst), emptying the frame onto a clean `[bg]`.
22
+
23
+ - Scene 2 — assemble the mark (~1.0–~Ys): the mark builds itself from parts.
24
+ - _Variant — Product_Intro_: seed dots SCALE UP into flat `[accent]` shapes arranged on the rings; concentric bands ripple outward (tunneling feel) and the shapes begin to ORBIT / drift around the still-fixed center.
25
+ - _Variant — CTA push_: the `[wordmark]` CASCADES out from behind the mark (letters left→right with overshoot) into the full `[brand lockup]`; the 3D mark may assemble in beats (a terminal detaches + pops as a spring dot, a part hinges-open-and-snaps-shut elastic). Optional beat: a `[cursor]` arcs in and "clicks" the wordmark, OR a frosted-glass pill holding an intermediate `[CTA line]` springs in while layered mark shells fan to the edges.
26
+ - _Variant — CTA button-build_: a graphic WIPE flips the frame to `[contrast bg]` — a thin `[accent]` diagonal line sweeps in, swells into a full-frame diagonal BAND, then collapses to a small `[accent]` slash.
27
+ - _Variant — Brand_Outro_: on the now-clear frame, the `[logo mark]` DRAWS ON via stroke (built arc-by-arc / segment-by-segment).
28
+
29
+ - Scene 3 — resolve to lockup (~Ys–end): the lockup completes and holds (Product_Intro / Brand_Outro) or is flown into / extended to a CTA (CTA variants).
30
+ - _Variant — Product_Intro (the ONE camera move)_: the whole system smoothly TILTS from flat top-down into an angled isometric perspective (ease-in-out) with a slight zoom-out — flat shapes become luminous 3D forms, bands become glowing orbit lines, while the central `[logo mark]` does NOT tilt (stays 2D, front-facing, fixed). Camera eases to a stop; elements keep continuous orbit/drift (inner faster than outer); the mark holds its steady glow. Final settled frame.
31
+ - _Variant — CTA push (the signature)_: a single fast CAMERA PUSH-THROUGH the mark's negative space / through the glass pill — heavy horizontal motion-blur, giant `[CTA]` letters streaking past the lens (cursor drops out). Resolves to the final lockup on a saturated `[bg]`: a `[url badge]` / `[CTA line]` revealed by a left→right WIPE carrying an `[accent]` leading edge (or a clean fade), with solid mark-shapes parallax-sliding in behind. Settles to a dead-static hold (slow zoom-out / settle).
32
+ - _Variant — CTA button-build_: the `[wordmark]` BUILDS letter-by-letter to the right of the slash, landing on the final "`[slash] [WORDMARK]`" lockup centered on the new bg. Slow settle to static.
33
+ - _Variant — Brand_Outro_: the `[wordmark]` reveals beside the drawn mark (slide / fade) to complete the `[lockup]`; the lockup holds, then fades to `[black / bg]`.
34
+
35
+ **motion vocabulary**: ring pulse / expand; background crossfade (light→dark); glow ignite; seed-dot scale-up; continuous orbit / drift (inner faster than outer); single 3D perspective tilt (flat→isometric) + slight zoom-out around a fixed 2D anchor; 3D logo assemble (part detach + spring dot, clapperboard hinge / snap, shell fan-out); wordmark cascade with overshoot (letters left→right); button pill rise / scale-in; animated stroke-outline DRAW + glow (button border AND logo mark); comet / spark accent; diagonal-band wipe (sweep → swell → collapse-to-slash); letter-by-letter wordmark build; pre-formed grid DISPERSE off all four edges; logo-mark stroke-draw (sequential arcs / segments); fast CAMERA PUSH-THROUGH with motion-blur (CTA spine); continuous slow push-in / push-out; cursor arc-in + click; parallax shape slide-in; left→right URL/badge wipe with glowing leading edge; static / fade-out end-lockup hold; optional idle breathe on the held mark.
36
+
37
+ **rule mapping** (per motion verb → `rules/<id>.md`)
38
+
39
+ - ring pulse / expand from center → `center-outward-expansion` (radiate from a shared center; reuse the 0→1 progress driver)
40
+ - background crossfade (light→dark gradient) → plain opacity/background tween via `gsap-effects` (no dedicated rule needed)
41
+ - glow ignite on the mark → `asr-keyword-glow` (envelope-driven glow on the brand element)
42
+ - seed-dot scale-up into shapes → `spring-pop-entrance` (scale-in pop; alt `scale-swap-transition` if dots morph into shapes)
43
+ - continuous orbit / drift around fixed center → `orbit-3d-entry` (flip-in then continuous elliptical orbit; center label = the fixed mark)
44
+ - single 3D perspective tilt (flat→isometric) + slight zoom-out → `multi-phase-camera` (scripted scale phases on a scene-wrapping camera, for the zoom-out) — see camera modifier; the FLAT→ISOMETRIC plane tilt of the whole stage is a CSS-3D perspective move (`techniques.md` CSS-3D, animating the stage's `rotateX`) — no exact camera rule for the plane-tilt, approximate via CSS-3D (closest reference is `orbit-3d-entry`'s "Tilted orbit plane" variation animated over time)
45
+ - fixed 2D anchor logo amid moving universe → no motion rule needed (static anchor; intentional — it's the absence of motion, the universe moves around it)
46
+ - 3D logo assemble — part detach + spring dot → `spring-pop-entrance` (spring pop, `back.out` overshoot)
47
+ - 3D logo assemble — hinge open / snap (clapperboard) → `hacker-flip-3d` (the 3D-rotate axis) + `techniques.md` CSS-3D (the elastic open-and-snap-shut hinge is an adaptation of the 3D-rotate)
48
+ - 3D logo assemble — shell fan-out to edges → `center-outward-expansion` (run outward from the mark center)
49
+ - wordmark cascade with overshoot (letters left→right) → recipe `gsap-effects` (per-element staggered slide) + `spring-pop-entrance` (the `back.out` overshoot per letter)
50
+ - button pill rise / scale-in → `spring-pop-entrance` (scale-in; alt `scale-swap-transition`)
51
+ - animated stroke-outline draw + glow (button border) → `svg-path-draw` (stroke-dashoffset draw) + `asr-keyword-glow` (the glow on the drawn stroke)
52
+ - comet / spark accent on button → `asr-keyword-glow` (small glow accent); motion path via `techniques.md` GSAP MotionPathPlugin (#9)
53
+ - diagonal-band wipe (sweep → swell → collapse-to-slash) → `techniques.md` clip-path reveal (#12, animate a `polygon(...)` diagonal across the frame; the swell-then-collapse-to-slash is the same clip-path reveal driven through grow→shrink keyframes)
54
+ - letter-by-letter wordmark build → `discrete-text-sequence` (smooth-slice / per-state build); recipe `gsap-effects` (typewriter / appending words)
55
+ - pre-formed grid disperse off all four edges → not a rule gap: a formation flying off-frame is an EXIT, and the pipeline forbids mid-video exits — the harness transition IS the exit (only the final frame may exit the stage). Treat this as transition-handled / final-frame-only rather than an in-scene motion rule. (If staged in-scene as a reveal-the-mark clear, it reuses `center-outward-expansion` run OUTWARD — center→target machinery interpolating formation→offscreen targets, out-easing.)
56
+ - logo-mark stroke-draw (sequential arcs / segments) → `svg-path-draw` (the canonical multi-segment stagger draw)
57
+ - wordmark slide / fade reveal beside drawn mark → `svg-path-draw` (its "brand-line fades in after stroke" tail) ; slide via `spring-pop-entrance`
58
+ - fast camera push-through with motion-blur → `multi-phase-camera` (a hard push phase) — see camera modifier; the heavy motion-blur streak itself → `motion-blur-streak` (directional velocity blur on the fast push-through)
59
+ - continuous slow push-in / push-out → `multi-phase-camera` (phase scale + drift)
60
+ - cursor arc-in + click on the wordmark → `cursor-click-ripple` (move → click → ripple); arc path via `techniques.md` MotionPathPlugin (#9)
61
+ - parallax shape slide-in behind lockup → `depth-scatter-assemble` (parallax depth slide-in of shapes at differing depths; pair with `3d-text-depth-layers` for the depth ordering)
62
+ - left→right URL / badge wipe with glowing leading edge → `techniques.md` clip-path reveal (#12, animate `inset()` left→right); the glowing leading edge → `asr-keyword-glow`
63
+ - static / fade-out end-lockup hold → no motion rule needed (terminal hold / opacity fade; intentional)
64
+ - idle breathe on held mark (optional) → `sine-wave-loop` (post-settle breathing)
65
+
66
+ **camera modifier** (the push / tilt)
67
+
68
+ - **CTA push-through** (the CTA spine): a scripted hard zoom phase on a scene-wrapping camera → `multi-phase-camera` ("Steady push" / "Bookend pull" pattern; push phase = the climax). When the mark is OFF-center and the camera must fly through a specific point of negative space, combine with `coordinate-target-zoom` (outer scales, inner counter-translates so the target negative-space point lands at viewport center as scale ramps; measure the offset at setup). The signature heavy horizontal MOTION-BLUR on the streak → `motion-blur-streak` (directional velocity blur on the push); realize with a CSS `filter: blur()` / duplicated-streak layer on the camera during the push window.
69
+ - **Product_Intro tilt** (the one cinematic move): the flat→isometric perspective tilt + slight zoom-out is a single scripted camera beat → `multi-phase-camera` (scale phase + the "Targeted zoom into off-center element" / drift machinery) for the zoom-out. `multi-phase-camera` is scale+translate+drift only, so the perspective-PLANE rotateX (flat top-down → angled isometric) of the whole stage is the CSS-3D move noted above — approximate via `techniques.md` CSS-3D, animating the stage's `rotateX` (closest reference is `orbit-3d-entry`'s "Tilted orbit plane" variation animated over time).
@@ -1,28 +1,28 @@
1
- # overwhelm-surround — Overwhelm / Close-In
2
-
3
- **intent**: Convey overwhelm by accumulation. Recognizable subjects assemble, density markers scatter in to amplify "look how much," then the central subject morphs into the viewer's own avatar and elements close in from ALL sides — the frame feels surrounded, not zoomed-into. The emotional arc is recognition → claustrophobia.
4
-
5
- **roles served**
6
-
7
- - Problem (from `problem-mockup-overwhelm`): when the problem beat must first show "too many tools / too much surface area" and then put **the viewer inside it** — a literal swap of subject (product → person) followed by a closing-in that feels invasive. Reach for it when the pain is "you're buried," not "this metric is bad" (that's `dataviz-countup`).
8
-
9
- **duration**: 6–9s
10
-
11
- **shot structure** (a `[bg]` canvas; recognizable surfaces first, the viewer's avatar revealed underneath, then a radial crowd)
12
-
13
- - **Scene 1 (0.0–~1.6s) — recognizable assembly.** Three `[product mockups / surfaces]` assemble into something the viewer knows — staggered scale-in, the **center** one full-size, the two flanks smaller (~0.86). Each rides a low-amplitude float so they feel like live context, not a static collage. Camera static.
14
- - **Scene 2 (~1.6–3.0s) — density amplifies.** `[platform icons / logos]` scatter in around the mockups (staggered), used purely as **density markers** — "look how much surface area," not animated dials.
15
- - **Scene 3 (~3.0–4.6s) — the morph (signature move).** The CENTER mockup MORPHS: its content fades out, the container reshapes, and the viewer's `[avatar]` is revealed **underneath** — a literal swap of subject, product → person.
16
- - **Scene 4 (~4.6–end) — close-in.** `[task bubbles / demands]` close in from ALL sides toward the avatar (radial staggered entry). The avatar **stays put** while the bubbles invade — the claustrophobia comes from being surrounded, never from a camera push. Holds on the crowded state.
17
-
18
- **motion vocabulary**: staggered scale-in assembly; resting-scale-preserving low float; density-marker icon scatter; content-fade → container-reshape → reveal-anchor-beneath morph; radial close-in entry from all compass points; held crowded end-state.
19
-
20
- **rule mapping**
21
-
22
- - staggered mockup + icon entries (smooth settle onto their resting scale) → `spring-pop-entrance` (smooth-settle register) backed by `gsap-effects`
23
- - platform icons as density markers (positions pre-baked, scale/opacity only — NOT internal-parts animation) → `svg-icon-enrichment` (its DOM contract only)
24
- - center mockup → avatar morph (HF forbids `width`/`height` tweens → drive the reshape on `scaleX`/`scaleY`, anchor = the avatar layer rendered beneath) → `card-morph-anchor`
25
- - radial bubble close-in (positions baked once via `cos`/`sin`, staggered entry) → `gsap-effects` (radial layout) + `spring-pop-entrance` (per-bubble arrival)
26
- - low-amplitude float on background mockups/icons → `sine-wave-loop` (low-amplitude register — subtle jitter that composes onto each element's resting scale, never a `fromTo` yoyo that re-tweens to its start)
27
-
28
- **camera modifier**: camera-static — the close-in must read as the world crowding the subject, so the frame holds; a push-in would convert "surrounded" into "zoomed-into" and kill the claustrophobia.
1
+ # overwhelm-surround — Overwhelm / Close-In
2
+
3
+ **intent**: Convey overwhelm by accumulation. Recognizable subjects assemble, density markers scatter in to amplify "look how much," then the central subject morphs into the viewer's own avatar and elements close in from ALL sides — the frame feels surrounded, not zoomed-into. The emotional arc is recognition → claustrophobia.
4
+
5
+ **roles served**
6
+
7
+ - Problem (from `problem-mockup-overwhelm`): when the problem beat must first show "too many tools / too much surface area" and then put **the viewer inside it** — a literal swap of subject (product → person) followed by a closing-in that feels invasive. Reach for it when the pain is "you're buried," not "this metric is bad" (that's `dataviz-countup`).
8
+
9
+ **duration**: 6–9s
10
+
11
+ **shot structure** (a `[bg]` canvas; recognizable surfaces first, the viewer's avatar revealed underneath, then a radial crowd)
12
+
13
+ - **Scene 1 (0.0–~1.6s) — recognizable assembly.** Three `[product mockups / surfaces]` assemble into something the viewer knows — staggered scale-in, the **center** one full-size, the two flanks smaller (~0.86). Each rides a low-amplitude float so they feel like live context, not a static collage. Camera static.
14
+ - **Scene 2 (~1.6–3.0s) — density amplifies.** `[platform icons / logos]` scatter in around the mockups (staggered), used purely as **density markers** — "look how much surface area," not animated dials.
15
+ - **Scene 3 (~3.0–4.6s) — the morph (signature move).** The CENTER mockup MORPHS: its content fades out, the container reshapes, and the viewer's `[avatar]` is revealed **underneath** — a literal swap of subject, product → person.
16
+ - **Scene 4 (~4.6–end) — close-in.** `[task bubbles / demands]` close in from ALL sides toward the avatar (radial staggered entry). The avatar **stays put** while the bubbles invade — the claustrophobia comes from being surrounded, never from a camera push. Holds on the crowded state.
17
+
18
+ **motion vocabulary**: staggered scale-in assembly; resting-scale-preserving low float; density-marker icon scatter; content-fade → container-reshape → reveal-anchor-beneath morph; radial close-in entry from all compass points; held crowded end-state.
19
+
20
+ **rule mapping**
21
+
22
+ - staggered mockup + icon entries (smooth settle onto their resting scale) → `spring-pop-entrance` (smooth-settle register) backed by `gsap-effects`
23
+ - platform icons as density markers (positions pre-baked, scale/opacity only — NOT internal-parts animation) → `svg-icon-enrichment` (its DOM contract only)
24
+ - center mockup → avatar morph (HF forbids `width`/`height` tweens → drive the reshape on `scaleX`/`scaleY`, anchor = the avatar layer rendered beneath) → `card-morph-anchor`
25
+ - radial bubble close-in (positions baked once via `cos`/`sin`, staggered entry) → `gsap-effects` (radial layout) + `spring-pop-entrance` (per-bubble arrival)
26
+ - low-amplitude float on background mockups/icons → `sine-wave-loop` (low-amplitude register — subtle jitter that composes onto each element's resting scale, never a `fromTo` yoyo that re-tweens to its start)
27
+
28
+ **camera modifier**: camera-static — the close-in must read as the world crowding the subject, so the frame holds; a push-in would convert "surrounded" into "zoomed-into" and kill the claustrophobia.