kaizen-agent 1.48.0 → 1.49.1

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 (232) hide show
  1. package/README.md +2 -2
  2. package/cli/build-web.ts +4 -2
  3. package/cli/hermes.ts +68 -0
  4. package/cli/install.ts +18 -5
  5. package/cli/localsend.test.ts +84 -0
  6. package/cli/localsend.ts +131 -0
  7. package/cli/notes.test.ts +6 -4
  8. package/cli/settings.ts +1 -0
  9. package/cli/state.test.ts +50 -0
  10. package/cli/state.ts +47 -20
  11. package/cli/versions.test.ts +154 -0
  12. package/cli/versions.ts +272 -0
  13. package/cli/video.test.ts +540 -0
  14. package/cli/video.ts +600 -0
  15. package/cli/web.ts +142 -1
  16. package/package.json +1 -1
  17. package/skills/kaizen/config.default.yml +4 -0
  18. package/skills/media/kaizen-book/SKILL.md +107 -0
  19. package/skills/media/kaizen-book/assets/reader.html +440 -0
  20. package/skills/media/kaizen-book/assets/styles.json +45 -0
  21. package/skills/media/kaizen-book/examples/book.json +14 -0
  22. package/skills/media/kaizen-book/examples/images/reach.svg +1 -0
  23. package/skills/media/kaizen-book/examples/manuscript.md +127 -0
  24. package/skills/media/kaizen-book/references/interview.md +85 -0
  25. package/skills/media/kaizen-book/references/proofread.md +47 -0
  26. package/skills/media/kaizen-book/references/writing.md +53 -0
  27. package/skills/media/kaizen-book/scripts/build_book.py +279 -0
  28. package/skills/media/kaizen-book/scripts/check.sh +10 -0
  29. package/skills/media/kaizen-book/scripts/check_book.py +128 -0
  30. package/skills/media/kaizen-book/scripts/deploy.py +58 -0
  31. package/skills/media/kaizen-book/scripts/pdf.mjs +99 -0
  32. package/skills/media/kaizen-book/scripts/setup.sh +9 -0
  33. package/skills/media/kaizen-book/scripts/verify.mjs +95 -0
  34. package/skills/{story-deck → media/kaizen-deck}/SKILL.md +1 -1
  35. package/skills/{story-deck → media/kaizen-deck}/scripts/check.sh +1 -1
  36. package/skills/{story-deck → media/kaizen-deck}/scripts/install_fonts.py +2 -2
  37. package/skills/media/kaizen-video/SKILL.md +130 -0
  38. package/skills/{kaizen-video → media/kaizen-video}/assets/CREDITS.txt +5 -0
  39. package/skills/media/kaizen-video/assets/film-fonts/Fraunces.ttf +0 -0
  40. package/skills/media/kaizen-video/assets/film-fonts/Inter.ttf +0 -0
  41. package/skills/media/kaizen-video/assets/film-fonts/PlayfairDisplay-Italic.ttf +0 -0
  42. package/skills/media/kaizen-video/assets/film-fonts/PlayfairDisplay.ttf +0 -0
  43. package/skills/media/kaizen-video/canvas.html +241 -0
  44. package/skills/media/kaizen-video/examples/canvas-film/cat.txt +31 -0
  45. package/skills/media/kaizen-video/examples/canvas-film/film.json +460 -0
  46. package/skills/media/kaizen-video/examples/canvas-film/lines.json +10 -0
  47. package/skills/media/kaizen-video/examples/canvas-film/skip.txt +18 -0
  48. package/skills/media/kaizen-video/examples/canvas-film/talk.txt +23 -0
  49. package/skills/media/kaizen-video/examples/canvas-film/wow.txt +24 -0
  50. package/skills/media/kaizen-video/examples/kaizen-promo/promo.json +17 -0
  51. package/skills/media/kaizen-video/examples/kaizen-promo/record.json +10 -0
  52. package/skills/media/kaizen-video/examples/notula-promo/promo.json +41 -0
  53. package/skills/media/kaizen-video/examples/notula-promo/record.json +135 -0
  54. package/skills/media/kaizen-video/examples/notula-promo/seed.php +20 -0
  55. package/skills/media/kaizen-video/examples/notula-promo/seed.py +38 -0
  56. package/skills/media/kaizen-video/examples/sample-film/README.md +10 -0
  57. package/skills/media/kaizen-video/examples/sample-film/film.json +63 -0
  58. package/skills/media/kaizen-video/film.html +246 -0
  59. package/skills/media/kaizen-video/presets/app-promo/CREDITS.txt +2 -0
  60. package/skills/media/kaizen-video/presets/app-promo/README.md +21 -0
  61. package/skills/media/kaizen-video/presets/app-promo/preset.json +7 -0
  62. package/skills/media/kaizen-video/presets/app-promo/template/compositions/end.html +25 -0
  63. package/skills/media/kaizen-video/presets/app-promo/template/compositions/hook.html +19 -0
  64. package/skills/media/kaizen-video/presets/app-promo/template/compositions/name.html +19 -0
  65. package/skills/media/kaizen-video/presets/app-promo/template/compositions/step.html +52 -0
  66. package/skills/media/kaizen-video/presets/app-promo/template/index.html +24 -0
  67. package/skills/media/kaizen-video/presets/film-cinematic-drama/.hidden +1 -0
  68. package/skills/media/kaizen-video/presets/film-cinematic-drama/CREDITS.txt +1 -0
  69. package/skills/media/kaizen-video/presets/film-cinematic-drama/README.md +2 -0
  70. package/skills/media/kaizen-video/presets/film-cinematic-drama/style.json +39 -0
  71. package/skills/media/kaizen-video/presets/film-explainer-canvas/.hidden +1 -0
  72. package/skills/media/kaizen-video/presets/film-explainer-canvas/CREDITS.txt +3 -0
  73. package/skills/media/kaizen-video/presets/film-explainer-canvas/README.md +7 -0
  74. package/skills/media/kaizen-video/presets/film-explainer-canvas/assets/fonts/InstrumentSerif.ttf +0 -0
  75. package/skills/media/kaizen-video/presets/film-explainer-canvas/assets/fonts/SpaceMono.ttf +0 -0
  76. package/skills/media/kaizen-video/presets/film-explainer-canvas/assets/sfx/boing.wav +0 -0
  77. package/skills/media/kaizen-video/presets/film-explainer-canvas/assets/sfx/ding.wav +0 -0
  78. package/skills/media/kaizen-video/presets/film-explainer-canvas/assets/sfx/ending.wav +0 -0
  79. package/skills/media/kaizen-video/presets/film-explainer-canvas/assets/sfx/pop.wav +0 -0
  80. package/skills/media/kaizen-video/presets/film-explainer-canvas/assets/sfx/reveal.wav +0 -0
  81. package/skills/media/kaizen-video/presets/film-explainer-canvas/assets/sfx/shutter.wav +0 -0
  82. package/skills/media/kaizen-video/presets/film-explainer-canvas/assets/sfx/stamp.wav +0 -0
  83. package/skills/media/kaizen-video/presets/film-explainer-canvas/assets/sfx/tick.wav +0 -0
  84. package/skills/media/kaizen-video/presets/film-explainer-canvas/assets/sfx/whoosh.wav +0 -0
  85. package/skills/media/kaizen-video/presets/film-explainer-canvas/style.json +15 -0
  86. package/skills/media/kaizen-video/presets/film-fun-energetic/.hidden +1 -0
  87. package/skills/media/kaizen-video/presets/film-fun-energetic/CREDITS.txt +1 -0
  88. package/skills/media/kaizen-video/presets/film-fun-energetic/README.md +2 -0
  89. package/skills/media/kaizen-video/presets/film-fun-energetic/style.json +39 -0
  90. package/skills/media/kaizen-video/presets/film-promo-booth/.hidden +1 -0
  91. package/skills/media/kaizen-video/presets/film-promo-booth/CREDITS.txt +1 -0
  92. package/skills/media/kaizen-video/presets/film-promo-booth/README.md +2 -0
  93. package/skills/media/kaizen-video/presets/film-promo-booth/style.json +39 -0
  94. package/skills/media/kaizen-video/presets/film-viral-social/.hidden +1 -0
  95. package/skills/media/kaizen-video/presets/film-viral-social/CREDITS.txt +1 -0
  96. package/skills/media/kaizen-video/presets/film-viral-social/README.md +2 -0
  97. package/skills/media/kaizen-video/presets/film-viral-social/style.json +39 -0
  98. package/skills/media/kaizen-video/presets/tiktok-explainer/CREDITS.txt +3 -0
  99. package/skills/media/kaizen-video/presets/tiktok-explainer/README.md +52 -0
  100. package/skills/media/kaizen-video/presets/tiktok-explainer/assets/fonts/InstrumentSerif.ttf +0 -0
  101. package/skills/media/kaizen-video/presets/tiktok-explainer/assets/fonts/SpaceMono.ttf +0 -0
  102. package/skills/media/kaizen-video/presets/tiktok-explainer/assets/sfx/boing.wav +0 -0
  103. package/skills/media/kaizen-video/presets/tiktok-explainer/assets/sfx/ding.wav +0 -0
  104. package/skills/media/kaizen-video/presets/tiktok-explainer/assets/sfx/ending.wav +0 -0
  105. package/skills/media/kaizen-video/presets/tiktok-explainer/assets/sfx/pop.wav +0 -0
  106. package/skills/media/kaizen-video/presets/tiktok-explainer/assets/sfx/reveal.wav +0 -0
  107. package/skills/media/kaizen-video/presets/tiktok-explainer/assets/sfx/shutter.wav +0 -0
  108. package/skills/media/kaizen-video/presets/tiktok-explainer/assets/sfx/stamp.wav +0 -0
  109. package/skills/media/kaizen-video/presets/tiktok-explainer/assets/sfx/tick.wav +0 -0
  110. package/skills/media/kaizen-video/presets/tiktok-explainer/assets/sfx/whoosh.wav +0 -0
  111. package/skills/media/kaizen-video/presets/tiktok-explainer/index.html +272 -0
  112. package/skills/media/kaizen-video/presets/tiktok-explainer/package.json +10 -0
  113. package/skills/media/kaizen-video/references/canvas.md +60 -0
  114. package/skills/media/kaizen-video/references/presets.md +107 -0
  115. package/skills/{story-video → media/kaizen-video}/references/production.md +2 -2
  116. package/skills/media/kaizen-video/references/promo.md +148 -0
  117. package/skills/media/kaizen-video/references/revisions.md +34 -0
  118. package/skills/media/kaizen-video/scripts/__pycache__/intake.cpython-314.pyc +0 -0
  119. package/skills/media/kaizen-video/scripts/__pycache__/make_film.cpython-314.pyc +0 -0
  120. package/skills/media/kaizen-video/scripts/__pycache__/make_tiktok.cpython-314.pyc +0 -0
  121. package/skills/media/kaizen-video/scripts/__pycache__/render_cut.cpython-314.pyc +0 -0
  122. package/skills/media/kaizen-video/scripts/__pycache__/sfx.cpython-314.pyc +0 -0
  123. package/skills/media/kaizen-video/scripts/__pycache__/srt.cpython-314.pyc +0 -0
  124. package/skills/media/kaizen-video/scripts/__pycache__/transcribe.cpython-314.pyc +0 -0
  125. package/skills/media/kaizen-video/scripts/__pycache__/vo.cpython-314.pyc +0 -0
  126. package/skills/{kaizen-video → media/kaizen-video}/scripts/check.sh +8 -0
  127. package/skills/{story-video → media/kaizen-video}/scripts/intake.py +2 -2
  128. package/skills/media/kaizen-video/scripts/make_film.py +416 -0
  129. package/skills/media/kaizen-video/scripts/make_promo.py +297 -0
  130. package/skills/{kaizen-video → media/kaizen-video}/scripts/make_tiktok.py +42 -9
  131. package/skills/{story-video → media/kaizen-video}/scripts/master.sh +12 -11
  132. package/skills/media/kaizen-video/scripts/pixel.py +40 -0
  133. package/skills/media/kaizen-video/scripts/record.mjs +103 -0
  134. package/skills/{story-video → media/kaizen-video}/scripts/sfx.py +3 -3
  135. package/skills/media/kaizen-video/scripts/srt.py +9 -0
  136. package/skills/media/kaizen-video/scripts/still.sh +7 -0
  137. package/web/board/views.ts +1 -1
  138. package/web/board.html +3 -1
  139. package/web/board.js +2 -2
  140. package/web/notebook.js +1 -1
  141. package/web/notes.html +2 -0
  142. package/web/term.js +1 -1
  143. package/web/video.html +332 -0
  144. package/web/video.js +92 -0
  145. package/web/video.ts +843 -0
  146. package/skills/kaizen-video/SKILL.md +0 -73
  147. package/skills/kaizen-video/references/presets.md +0 -54
  148. package/skills/story-video/SKILL.md +0 -108
  149. package/skills/story-video/engine/package.json +0 -12
  150. package/skills/story-video/engine/src/Root.tsx +0 -24
  151. package/skills/story-video/engine/src/engine/Film.tsx +0 -405
  152. package/skills/story-video/engine/src/engine/presets.json +0 -58
  153. package/skills/story-video/engine/src/index.ts +0 -3
  154. package/skills/story-video/engine/tsconfig.json +0 -1
  155. package/skills/story-video/examples/sample-film/README.md +0 -12
  156. package/skills/story-video/examples/sample-film/film.json +0 -16
  157. package/skills/story-video/references/presets.md +0 -21
  158. package/skills/story-video/references/revisions.md +0 -25
  159. package/skills/story-video/scripts/check.sh +0 -19
  160. package/skills/story-video/scripts/setup.sh +0 -25
  161. package/skills/story-video/scripts/srt.py +0 -30
  162. package/skills/story-video/scripts/still.sh +0 -10
  163. /package/skills/{story-deck → media/kaizen-deck}/examples/build-example.js +0 -0
  164. /package/skills/{story-deck → media/kaizen-deck}/references/rules.md +0 -0
  165. /package/skills/{story-deck → media/kaizen-deck}/references/story-arc.md +0 -0
  166. /package/skills/{story-deck → media/kaizen-deck}/scripts/kit.js +0 -0
  167. /package/skills/{story-deck → media/kaizen-deck}/scripts/prep_images.py +0 -0
  168. /package/skills/{story-deck → media/kaizen-deck}/scripts/qa.sh +0 -0
  169. /package/skills/{kaizen-video → media/kaizen-video}/assets/fonts/Fredoka.ttf +0 -0
  170. /package/skills/{kaizen-video → media/kaizen-video}/assets/fonts/Montserrat.ttf +0 -0
  171. /package/skills/{kaizen-video → media/kaizen-video}/assets/fonts/SpecialElite.ttf +0 -0
  172. /package/skills/{kaizen-video → media/kaizen-video}/assets/music/investigations.mp3 +0 -0
  173. /package/skills/{kaizen-video → media/kaizen-video}/assets/music/lights.mp3 +0 -0
  174. /package/skills/{kaizen-video → media/kaizen-video}/assets/music/sunny.mp3 +0 -0
  175. /package/skills/{kaizen-video → media/kaizen-video}/examples/config.json +0 -0
  176. /package/skills/{story-video → media/kaizen-video}/examples/sample-film/lines.json +0 -0
  177. /package/skills/{kaizen-video → media/kaizen-video}/hyperframes.json +0 -0
  178. /package/skills/{kaizen-video → media/kaizen-video}/presets/educational-warning/CREDITS.txt +0 -0
  179. /package/skills/{kaizen-video → media/kaizen-video}/presets/educational-warning/README.md +0 -0
  180. /package/skills/{kaizen-video → media/kaizen-video}/presets/educational-warning/assets/sfx/ending.wav +0 -0
  181. /package/skills/{kaizen-video → media/kaizen-video}/presets/educational-warning/assets/sfx/reveal.wav +0 -0
  182. /package/skills/{kaizen-video → media/kaizen-video}/presets/educational-warning/assets/sfx/shutter.wav +0 -0
  183. /package/skills/{kaizen-video → media/kaizen-video}/presets/educational-warning/assets/sfx/stamp.wav +0 -0
  184. /package/skills/{kaizen-video → media/kaizen-video}/presets/educational-warning/index.html +0 -0
  185. /package/skills/{kaizen-video → media/kaizen-video}/presets/educational-warning/package.json +0 -0
  186. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-cheerful/CREDITS.txt +0 -0
  187. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-cheerful/README.md +0 -0
  188. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-cheerful/assets/sfx/boing.wav +0 -0
  189. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-cheerful/assets/sfx/chime.wav +0 -0
  190. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-cheerful/assets/sfx/ding.wav +0 -0
  191. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-cheerful/assets/sfx/ending.wav +0 -0
  192. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-cheerful/assets/sfx/pop.wav +0 -0
  193. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-cheerful/assets/sfx/reveal.wav +0 -0
  194. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-cheerful/assets/sfx/shutter.wav +0 -0
  195. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-cheerful/assets/sfx/stamp.wav +0 -0
  196. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-cheerful/assets/sfx/whoosh.wav +0 -0
  197. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-cheerful/index.html +0 -0
  198. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-cheerful/package.json +0 -0
  199. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-mystery/CREDITS.txt +0 -0
  200. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-mystery/README.md +0 -0
  201. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-mystery/assets/sfx/clock.wav +0 -0
  202. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-mystery/assets/sfx/ding.wav +0 -0
  203. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-mystery/assets/sfx/ending.wav +0 -0
  204. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-mystery/assets/sfx/heart.wav +0 -0
  205. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-mystery/assets/sfx/projector.wav +0 -0
  206. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-mystery/assets/sfx/reveal.wav +0 -0
  207. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-mystery/assets/sfx/shutter.wav +0 -0
  208. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-mystery/assets/sfx/stamp.wav +0 -0
  209. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-mystery/assets/sfx/whoosh.wav +0 -0
  210. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-mystery/index.html +0 -0
  211. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-mystery/package.json +0 -0
  212. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-scam-alert/CREDITS.txt +0 -0
  213. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-scam-alert/README.md +0 -0
  214. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-scam-alert/assets/sfx/clock.wav +0 -0
  215. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-scam-alert/assets/sfx/ding.wav +0 -0
  216. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-scam-alert/assets/sfx/ending.wav +0 -0
  217. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-scam-alert/assets/sfx/heart.wav +0 -0
  218. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-scam-alert/assets/sfx/reveal.wav +0 -0
  219. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-scam-alert/assets/sfx/shutter.wav +0 -0
  220. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-scam-alert/assets/sfx/stamp.wav +0 -0
  221. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-scam-alert/assets/sfx/whoosh.wav +0 -0
  222. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-scam-alert/index.html +0 -0
  223. /package/skills/{kaizen-video → media/kaizen-video}/presets/tiktok-scam-alert/package.json +0 -0
  224. /package/skills/{story-video → media/kaizen-video}/references/licensing.md +0 -0
  225. /package/skills/{story-video → media/kaizen-video}/references/script.md +0 -0
  226. /package/skills/{story-video → media/kaizen-video}/scripts/music.sh +0 -0
  227. /package/skills/{kaizen-video → media/kaizen-video}/scripts/render_cut.py +0 -0
  228. /package/skills/{kaizen-video → media/kaizen-video}/scripts/setup.sh +0 -0
  229. /package/skills/{kaizen-video → media/kaizen-video}/scripts/transcribe.py +0 -0
  230. /package/skills/{story-video → media/kaizen-video}/scripts/vo.py +0 -0
  231. /package/skills/{kaizen-video → media/kaizen-video}/tools/carve.mjs +0 -0
  232. /package/skills/{kaizen-video → media/kaizen-video}/tools/lib/main-module.mjs +0 -0
@@ -0,0 +1,272 @@
1
+ <!doctype html>
2
+ <html lang="id" data-resolution="portrait">
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <meta name="viewport" content="width=1080, height=1920" />
6
+ <script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
7
+ <script src="captions.js"></script>
8
+ <style>
9
+ @font-face { font-family: "Montserrat"; src: url("assets/fonts/Montserrat.ttf"); font-weight: 100 900; }
10
+ @font-face { font-family: "Instrument Serif"; src: url("assets/fonts/InstrumentSerif.ttf"); }
11
+ @font-face { font-family: "Space Mono"; src: url("assets/fonts/SpaceMono.ttf"); font-weight: 700; }
12
+ :root { --ink: #0c0b0a; --cream: #efe6d6; --orange: #f7a93b; --red: #ef4b3a; --dim: #8d867b; }
13
+ * { margin: 0; padding: 0; box-sizing: border-box; }
14
+ html, body { width: 1080px; height: 1920px; overflow: hidden; background: var(--ink); }
15
+ body { font-family: "Montserrat", sans-serif; color: var(--cream); }
16
+ #root { position: relative; width: 100%; height: 100%; overflow: hidden; background: var(--ink); }
17
+ .fill { position: absolute; inset: 0; }
18
+ .serif { font-family: "Instrument Serif", serif; font-weight: 400; }
19
+ .mono { font-family: "Space Mono", monospace; font-weight: 700; }
20
+ .acc { color: var(--orange); }
21
+
22
+ /* Background: near-black with two soft diagonal light streaks that drift. */
23
+ #streaks { inset: -30%; opacity: .9;
24
+ background:
25
+ linear-gradient(115deg, transparent 38%, rgba(239,230,214,.045) 44%, transparent 50%),
26
+ linear-gradient(115deg, transparent 58%, rgba(247,169,59,.05) 62%, transparent 67%); }
27
+ #vignette { background: radial-gradient(ellipse 85% 70% at 50% 45%, transparent 55%, rgba(0,0,0,.55) 100%); }
28
+
29
+ /* The speaker sits in a cream-framed clip card, like a frame pulled from an editor. */
30
+ #pose { position: absolute; left: 190px; top: 470px; width: 700px; height: 930px; }
31
+ #cam { position: absolute; inset: 0; border-radius: 34px; overflow: hidden;
32
+ border: 6px solid var(--cream); background: #1a1816; box-shadow: 0 40px 100px rgba(0,0,0,.75); transform-origin: 50% 50%; }
33
+ #a-roll { width: 100%; height: 100%; object-fit: cover; object-position: 50% 30%; filter: contrast(1.06) saturate(.92); }
34
+ #cam .chip { position: absolute; top: 22px; left: 22px; display: flex; align-items: center; gap: 10px; padding: 6px 14px;
35
+ border-radius: 10px; background: rgba(12,11,10,.72); font-size: 30px; color: var(--orange); }
36
+ #cam .chip b { width: 14px; height: 14px; border-radius: 50%; background: var(--red); }
37
+ #cam .shade { position: absolute; inset: 0; background: #000; opacity: 0; }
38
+
39
+ /* Hook: small serif setup line, then one huge headline. */
40
+ #hook { position: absolute; left: 70px; right: 70px; top: 150px; text-align: center; opacity: 0; }
41
+ #hook .setup { font-size: 64px; line-height: 1; opacity: .9; }
42
+ #hook h1 { margin-top: 8px; white-space: nowrap; font-weight: 900; font-size: 132px; line-height: .95; letter-spacing: -4px; }
43
+ #hook .sub { margin-top: 18px; font-size: 52px; color: var(--orange); }
44
+
45
+ /* Kinetic captions: words pop in as they are spoken; the spoken word is orange. */
46
+ #captions { position: absolute; left: 100px; right: 100px; top: 1450px; height: 250px; }
47
+ .chunk { position: absolute; inset: 0; display: flex; flex-wrap: wrap; justify-content: center; align-content: flex-start; gap: 0 22px; opacity: 0; }
48
+ .w { display: block; font-weight: 900; font-size: 80px; line-height: 1.08; letter-spacing: -2px; text-transform: lowercase;
49
+ color: var(--cream); opacity: 0; text-shadow: 0 6px 24px rgba(0,0,0,.85); }
50
+
51
+ /* Big numeral scene ("title" with "big"): outlined digit that fills up in orange. */
52
+ .scene { position: absolute; inset: 0; opacity: 0; }
53
+ .big { position: absolute; left: 40px; top: 40px; font-weight: 900; font-size: 980px; line-height: .9; letter-spacing: -40px; }
54
+ .big .o { color: transparent; -webkit-text-stroke: 6px var(--orange); }
55
+ .big .f { position: absolute; inset: 0; color: var(--orange); clip-path: inset(100% 0 0 0); }
56
+ .txt { position: absolute; left: 90px; right: 90px; top: 1130px; }
57
+ .txt .k { font-size: 62px; line-height: 1; }
58
+ .txt h1 { white-space: nowrap; font-weight: 900; font-size: 130px; line-height: .95; letter-spacing: -4px; margin-top: 6px; }
59
+ .txt .s { font-size: 64px; color: var(--orange); margin-top: 10px; }
60
+ .scene.center .txt { top: 760px; text-align: center; }
61
+ .scene .frame { width: 900px; height: 560px; margin: 0 auto 40px; border-radius: 30px; overflow: hidden; border: 6px solid var(--cream); }
62
+ .frame img { width: 100%; height: 100%; object-fit: cover; }
63
+ .scene.has-img .txt { top: 330px; }
64
+
65
+ /* Banner scene ("case"): headline on top, orange tape across the greyed clip, optional red stamp. */
66
+ .banner .head { position: absolute; left: 80px; right: 80px; top: 170px; text-align: center; }
67
+ .banner .head .k { font-size: 58px; line-height: 1; }
68
+ .banner .head h2 { font-weight: 900; font-size: 96px; line-height: 1; letter-spacing: -3px; margin-top: 8px; }
69
+ .tape { position: absolute; left: -60px; right: -60px; top: 800px; padding: 26px 80px; background: var(--orange); color: var(--ink);
70
+ transform: rotate(-6deg); text-align: center; font-weight: 900; font-size: 96px; line-height: 1; letter-spacing: -3px;
71
+ box-shadow: 0 0 0 10px var(--red), 0 30px 80px rgba(0,0,0,.7); }
72
+ .tape span { display: inline-block; }
73
+ .banner .stamp { position: absolute; left: 0; right: 0; top: 1130px; margin: auto; width: max-content; padding: 6px 30px;
74
+ border: 9px solid var(--red); color: var(--red); background: rgba(12,11,10,.55); font-weight: 900; font-size: 110px; letter-spacing: 2px; opacity: 0; }
75
+ .banner .s { position: absolute; left: 90px; right: 90px; top: 1480px; text-align: center; font-size: 60px; }
76
+
77
+ /* Photo card: slides in over the clip card's place. */
78
+ .photo { position: absolute; left: 150px; top: 430px; width: 780px; opacity: 0; display: flex; flex-direction: column; align-items: center; }
79
+ .photo .frame { width: 780px; height: 940px; border-radius: 34px; overflow: hidden; border: 6px solid var(--cream); box-shadow: 0 40px 100px rgba(0,0,0,.75); }
80
+ .photo p { margin-top: 26px; padding: 6px 18px; border-radius: 10px; background: rgba(239,230,214,.08); font-size: 34px; color: var(--orange); }
81
+
82
+ /* Steps list ("item"). */
83
+ #list { position: absolute; left: 90px; right: 90px; top: 700px; display: flex; flex-direction: column; gap: 40px; opacity: 0; }
84
+ #list .head { font-size: 66px; color: var(--orange); opacity: 0; }
85
+ .item { display: flex; align-items: center; gap: 30px; opacity: 0; }
86
+ .item b { flex: none; min-width: 120px; padding: 6px 14px; border-radius: 12px; background: var(--orange); color: var(--ink); text-align: center; font-size: 44px; }
87
+ .item span { font-weight: 900; font-size: 74px; line-height: 1; letter-spacing: -2px; }
88
+
89
+ /* Ending: stacked question, a giant orange glyph, a call to comment. */
90
+ .end .txt { top: 300px; text-align: center; }
91
+ .end .txt h1 { font-size: 120px; }
92
+ .end .glyph { position: absolute; left: 0; right: 0; top: 640px; text-align: center; font-weight: 900; font-size: 640px; line-height: 1; color: var(--orange);
93
+ text-shadow: 0 30px 90px rgba(247,169,59,.25); }
94
+ .end .s { position: absolute; left: 0; right: 0; top: 1500px; text-align: center; font-size: 58px; }
95
+
96
+ /* Optional mascot: drop mascot.png in the video's images/ folder. */
97
+ #mascot { position: absolute; left: 36px; bottom: 70px; width: 230px; height: 230px; opacity: 0; }
98
+ #mascot img { width: 100%; height: 100%; object-fit: contain; object-position: center bottom; }
99
+ </style>
100
+ </head>
101
+ <body>
102
+ <div id="root" data-composition-id="main" data-start="0" data-duration="{{DURATION}}" data-width="1080" data-height="1920">
103
+ <div id="streaks" class="fill"></div>
104
+ <div id="pose" data-layout-allow-overflow><div id="cam">
105
+ <video id="a-roll" class="clip" src="{{VIDEO}}" playsinline data-start="0" data-duration="{{VIDEO_DURATION}}" data-track-index="0" data-has-audio="true" data-fx-chain="{&quot;version&quot;: 1, &quot;nodes&quot;: [{&quot;type&quot;: &quot;highpass&quot;, &quot;id&quot;: &quot;n1&quot;, &quot;label&quot;: &quot;Remove Rumble&quot;, &quot;params&quot;: {&quot;frequency&quot;: 90, &quot;q&quot;: 0.707, &quot;poles&quot;: &quot;2&quot;}}, {&quot;type&quot;: &quot;compressor&quot;, &quot;id&quot;: &quot;n2&quot;, &quot;label&quot;: &quot;Even Out Loudness&quot;, &quot;params&quot;: {&quot;threshold&quot;: -26, &quot;ratio&quot;: 3, &quot;attack&quot;: 10, &quot;release&quot;: 200, &quot;knee&quot;: 2.83, &quot;makeup&quot;: 6, &quot;mix&quot;: 1}}, {&quot;type&quot;: &quot;gain&quot;, &quot;id&quot;: &quot;n3&quot;, &quot;label&quot;: &quot;Level Up&quot;, &quot;params&quot;: {&quot;gain&quot;: 5}}, {&quot;type&quot;: &quot;truepeak&quot;, &quot;id&quot;: &quot;n4&quot;, &quot;label&quot;: &quot;Peak Ceiling&quot;, &quot;params&quot;: {&quot;ceiling&quot;: -1.5, &quot;lookahead&quot;: 3, &quot;release&quot;: 80}}]}"></video>
106
+ <div class="shade"></div>
107
+ <div class="chip mono"><b></b><span id="tc">0:00</span></div>
108
+ </div></div>
109
+ <div id="vignette" class="fill"></div>
110
+
111
+ <div id="hook"><div class="setup serif">{{HOOK_1}}</div><h1>{{HOOK_2}}</h1><div class="sub serif">{{HOOK_SUB}}</div></div>
112
+ <div id="beats"></div>
113
+ <div id="list"></div>
114
+ <div id="captions"></div>
115
+ <div id="mascot"></div>
116
+
117
+ <audio id="music" src="assets/music.wav" data-start="0" data-duration="{{DURATION}}" data-track-index="2" data-volume="{{MUSIC_VOLUME}}"></audio>
118
+ <!-- SFX:BEGIN --><!-- SFX:END -->
119
+ </div>
120
+
121
+ <script>
122
+ const END = {{DURATION}}, VEND = {{VIDEO_DURATION}}, HOOK = 3.0, DUR = { title: 1.8, case: 3.2, photo: 2.8 };
123
+ const tl = gsap.timeline({ paused: true });
124
+ const el = (tag, cls, html) => { const e = document.createElement(tag); if (cls) e.className = cls; if (html) e.innerHTML = html; return e; };
125
+ const esc = s => String(s ?? "").replace(/[&<>"]/g, c => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" }[c]));
126
+ // Trailing ? or ! in a headline turns orange, as in the reference ("BASA-BASI?").
127
+ const punch = s => esc(s).replace(/([?!.]+)$/, '<span class="acc">$1</span>');
128
+ // Shrink a headline wider than the safe area.
129
+ const fit = (n, max = 900) => n.querySelectorAll("h1, h2").forEach(h => { const w = h.scrollWidth; if (w > max) h.style.fontSize = Math.floor(parseFloat(getComputedStyle(h).fontSize) * max / w) + "px"; });
130
+
131
+ // Clip card idles with a slight tilt that flips on every jump cut, plus a slow push.
132
+ const REST = i => ({ x: 0, y: 0, rotation: i % 2 ? 1.6 : -1.6, scale: i % 2 ? 1.03 : 1 });
133
+ SEG_STARTS.forEach((s, i) => tl.fromTo("#cam", { ...REST(i) }, { scale: REST(i).scale + 0.02, duration: (SEG_STARTS[i + 1] ?? END) - s, ease: "none", immediateRender: i === 0 }, s));
134
+ tl.fromTo("#streaks", { x: -60 }, { x: 60, duration: END, ease: "none" }, 0);
135
+ // Timecode on the card counts the footage time.
136
+ const tc = document.getElementById("tc");
137
+ for (let i = 0; i <= Math.floor(VEND); i++) tl.call(() => { tc.textContent = `${Math.floor(i / 60)}:${String(i % 60).padStart(2, "0")}`; }, null, i);
138
+
139
+ // Clip card poses while a card is on screen: tucked top-right, greyed in place, or swept off to the left.
140
+ const POSE = {
141
+ aside: { x: 250, y: -330, rotation: 5, scale: 0.42 },
142
+ grey: { scale: 0.96 },
143
+ away: { x: -980, rotation: -10 },
144
+ };
145
+ const pose = (kind, t, d) => {
146
+ tl.to("#pose", { ...POSE[kind], duration: 0.4, ease: "power3.inOut" }, t);
147
+ tl.to("#cam .shade", { opacity: kind === "grey" ? 0.55 : kind === "aside" ? 0.2 : 0, duration: 0.3 }, t);
148
+ if (kind === "grey") tl.to("#a-roll", { filter: "contrast(1.06) saturate(0) blur(3px)", duration: 0.3 }, t);
149
+ if (t + d >= END) return;
150
+ const back = t + d - 0.35;
151
+ tl.to("#pose", { x: 0, y: 0, rotation: 0, scale: 1, duration: 0.35, ease: "power3.inOut" }, back);
152
+ tl.to("#cam .shade", { opacity: 0, duration: 0.3 }, back);
153
+ if (kind === "grey") tl.to("#a-roll", { filter: "contrast(1.06) saturate(.92) blur(0px)", duration: 0.3 }, back);
154
+ };
155
+
156
+ // Hook.
157
+ const hook = document.getElementById("hook");
158
+ hook.querySelector("h1").innerHTML = punch(hook.querySelector("h1").textContent);
159
+ fit(hook);
160
+ tl.fromTo("#hook", { opacity: 0, y: -30 }, { opacity: 1, y: 0, duration: 0.4, ease: "power3.out" }, 0.05);
161
+ tl.fromTo("#hook h1", { scale: 1.25 }, { scale: 1, duration: 0.45, ease: "back.out(1.6)" }, 0.12);
162
+ tl.to("#hook", { opacity: 0, duration: 0.3 }, HOOK - 0.3);
163
+
164
+ const beats = document.getElementById("beats"), list = document.getElementById("list");
165
+ const pic = b => b.img ? `<div class="frame"><img src="assets/img/${esc(b.img)}" alt="" data-layout-allow-overflow></div>` : "";
166
+ const kb = (n, t, d) => { const im = n.querySelector(".frame img"); if (im) tl.fromTo(im, { scale: 1.12 }, { scale: 1, duration: d, ease: "none" }, t); };
167
+ let listStart = null;
168
+ BEATS.forEach((b, i) => {
169
+ const d = b.dur ?? DUR[b.kind];
170
+ if (b.kind === "title") {
171
+ // Keyword scene: card tucks aside; optional giant outlined numeral that fills up in orange.
172
+ const big = b.big ? `<div class="big"><span class="o" data-layout-ignore>${esc(b.big)}</span><span class="f">${esc(b.big)}</span></div>` : "";
173
+ const n = el("div", "scene" + (b.big ? "" : " center") + (b.img ? " has-img" : ""), big +
174
+ `<div class="txt">${pic(b)}${b.kicker ? `<div class="k serif">${esc(b.kicker)}</div>` : ""}<h1>${punch(b.title)}</h1>` +
175
+ (b.sub ? `<div class="s serif">${esc(b.sub)}</div>` : "") + "</div>");
176
+ beats.append(n); fit(n); pose("aside", b.t, d); kb(n, b.t, d);
177
+ tl.set(n, { opacity: 1 }, b.t);
178
+ if (b.big) {
179
+ tl.fromTo(n.querySelector(".big"), { opacity: 0, y: 80 }, { opacity: 1, y: 0, duration: 0.35, ease: "power3.out" }, b.t);
180
+ tl.fromTo(n.querySelector(".big .f"), { clipPath: "inset(100% 0 0 0)" }, { clipPath: "inset(0% 0 0 0)", duration: Math.min(1.2, d * 0.6), ease: "power2.inOut" }, b.t + 0.3);
181
+ }
182
+ const parts = n.querySelectorAll(".txt > *");
183
+ parts.forEach((p, j) => tl.fromTo(p, { opacity: 0, y: 40 }, { opacity: 1, y: 0, duration: 0.3, ease: "power3.out" }, b.t + 0.12 + j * 0.22));
184
+ tl.to(n, { opacity: 0, duration: 0.25 }, b.t + d - 0.25);
185
+ } else if (b.kind === "case") {
186
+ // Banner scene: headline on top, orange tape across the greyed clip card, red stamp slammed on.
187
+ const n = el("div", "scene banner",
188
+ `<div class="head">${b.kicker ? `<div class="k serif">${esc(b.kicker)}</div>` : ""}${b.sub ? `<h2>${punch(b.sub)}</h2>` : ""}</div>` +
189
+ `<div class="tape" data-layout-allow-overflow>${esc(b.title).split(" ").map(w => `<span>${w}</span>`).join(" ")}</div>` +
190
+ (b.stamp ? `<div class="stamp" data-layout-allow-overlap>${esc(b.stamp)}</div>` : "") +
191
+ (b.note ? `<div class="s serif">${esc(b.note)}</div>` : ""));
192
+ beats.append(n); fit(n); pose("grey", b.t, d);
193
+ tl.set(n, { opacity: 1 }, b.t);
194
+ tl.fromTo(n.querySelector(".head"), { opacity: 0, y: -40 }, { opacity: 1, y: 0, duration: 0.3, ease: "power3.out" }, b.t + 0.05);
195
+ tl.fromTo(n.querySelector(".tape"), { xPercent: -110 }, { xPercent: 0, duration: 0.35, ease: "power4.out" }, b.t + 0.25);
196
+ tl.fromTo(n.querySelectorAll(".tape span"), { scale: 1.4, opacity: 0 }, { scale: 1, opacity: 1, duration: 0.2, stagger: 0.07, ease: "back.out(2)" }, b.t + 0.4);
197
+ const st = n.querySelector(".stamp");
198
+ if (st) tl.fromTo(st, { opacity: 0, scale: 2.4, rotation: -20 }, { opacity: 1, scale: 1, rotation: -8, duration: 0.22, ease: "power4.in" }, b.t + 1.12 - 0.22);
199
+ const s = n.querySelector(".s");
200
+ if (s) tl.fromTo(s, { opacity: 0 }, { opacity: 1, duration: 0.3 }, b.t + 0.6);
201
+ tl.to(n, { opacity: 0, duration: 0.3 }, b.t + d - 0.3);
202
+ } else if (b.kind === "photo") {
203
+ // Photo card sweeps the clip card off and takes its place.
204
+ const n = el("div", "photo", pic(b) + (b.label ? `<p class="mono">${esc(b.label)}</p>` : ""));
205
+ beats.append(n); pose("away", b.t, d); kb(n, b.t, d);
206
+ tl.fromTo(n, { opacity: 0, x: 900, rotation: 8 }, { opacity: 1, x: 0, rotation: 1.5, duration: 0.45, ease: "power3.out" }, b.t + 0.05);
207
+ if (b.t + d < END) tl.to(n, { opacity: 0, x: 900, rotation: 8, duration: 0.35, ease: "power3.in" }, b.t + d - 0.35);
208
+ } else if (b.kind === "item") {
209
+ // Steps: orange mono chip plus a bold line, popped in on the word.
210
+ if (listStart === null) { listStart = b.t; if (b.head) { const h = el("div", "head serif"); h.textContent = b.head; list.append(h); } }
211
+ const k = list.querySelectorAll(".item").length + 1;
212
+ const n = el("div", "item", `<b class="mono">${esc(b.label ?? String(k).padStart(2, "0"))}</b><span>${punch(b.text)}</span>`);
213
+ list.append(n);
214
+ tl.fromTo(n, { opacity: 0, x: -60 }, { opacity: 1, x: 0, duration: 0.3, ease: "back.out(1.8)" }, b.t);
215
+ tl.fromTo(n.querySelector("b"), { scale: 1.5 }, { scale: 1, duration: 0.25, ease: "power3.out" }, b.t);
216
+ } else if (b.kind === "mascot") {
217
+ // Optional corner mascot from the video's images/, shown from its word on.
218
+ const m = document.getElementById("mascot"); m.innerHTML = `<img src="assets/img/${esc(b.img)}" alt="">`;
219
+ tl.fromTo(m, { opacity: 0, y: 120 }, { opacity: 1, y: 0, duration: 0.4, ease: "back.out(1.8)" }, b.t);
220
+ tl.fromTo(m.firstChild, { y: 0 }, { y: -10, duration: 0.6, ease: "sine.inOut", yoyo: true, repeat: Math.max(0, Math.floor((END - b.t) / 0.6) - 1) }, b.t + 0.4);
221
+ } else if (b.kind === "end") {
222
+ // Ending: the question stacks in, a giant orange glyph bounces in on the hit, then a call to comment.
223
+ const n = el("div", "scene end", `<div class="txt">${String(b.title).split("\n").map(l => `<h1>${punch(l)}</h1>`).join("")}</div>` +
224
+ `<div class="glyph">${esc(b.big ?? "?")}</div>` + (b.sub ? `<div class="s serif">${esc(b.sub)}</div>` : ""));
225
+ beats.append(n); fit(n); pose("aside", b.t, END - b.t);
226
+ tl.to("#pose", { opacity: 0, duration: 0.4 }, b.t + 0.2);
227
+ tl.set(n, { opacity: 1 }, b.t);
228
+ n.querySelectorAll(".txt h1").forEach((h, j) => tl.fromTo(h, { opacity: 0, y: 50 }, { opacity: 1, y: 0, duration: 0.3, ease: "power3.out" }, b.t + j * 0.18));
229
+ const land = b.t + 0.54; // the ending sting's hit
230
+ const g = n.querySelector(".glyph");
231
+ tl.fromTo(g, { opacity: 0, scale: 0.2, rotation: -20 }, { opacity: 1, scale: 1, rotation: 0, duration: 0.5, ease: "back.out(2.2)" }, land - 0.2);
232
+ tl.to(g, { rotation: 6, duration: 0.5, ease: "sine.inOut", yoyo: true, repeat: Math.max(0, Math.floor((END - land - 0.3) / 0.5)) }, land + 0.3);
233
+ const s = n.querySelector(".s");
234
+ if (s) tl.fromTo(s, { opacity: 0, y: 20 }, { opacity: 1, y: 0, duration: 0.4 }, land + 0.4);
235
+ }
236
+ });
237
+ // The steps leave at the first jump cut after the last item (max 6 s later).
238
+ const items = BEATS.filter(b => b.kind === "item"), lastItem = items.length ? items[items.length - 1].t : 0;
239
+ const listEnd = Math.min(SEG_STARTS.find(s => s > lastItem + 1) ?? END, lastItem + 6);
240
+ if (items.length) {
241
+ const a = listStart - 0.4;
242
+ pose("aside", a, listEnd - a);
243
+ tl.fromTo("#list", { opacity: 0 }, { opacity: 1, duration: 0.25 }, a);
244
+ const h = list.querySelector(".head");
245
+ if (h) tl.fromTo(h, { opacity: 0, y: 30 }, { opacity: 1, y: 0, duration: 0.3 }, a);
246
+ tl.to("#list", { opacity: 0, duration: 0.3 }, listEnd - 0.3);
247
+ }
248
+
249
+ // Captions: hidden while a scene owns the screen (photo cards keep them).
250
+ const busy = BEATS.filter(b => !["item", "photo", "mascot"].includes(b.kind)).map(b => [b.t, b.kind === "end" ? END : b.t + (b.dur ?? DUR[b.kind])])
251
+ .concat(items.length ? [[listStart - 0.4, listEnd]] : []).concat([[0, HOOK]]);
252
+ const cap = document.getElementById("captions");
253
+ CAPTIONS.forEach(chunk => {
254
+ const start = chunk[0].s, end = chunk[chunk.length - 1].hold;
255
+ if (busy.some(([a, b]) => start < b && end > a)) return;
256
+ const n = el("div", "chunk"); cap.append(n);
257
+ tl.set(n, { opacity: 1 }, start);
258
+ tl.set(n, { opacity: 0 }, end);
259
+ chunk.forEach((w, j) => {
260
+ const s = el("span", "w"); s.textContent = w.w.replace(/[,.]+$/, ""); n.append(s);
261
+ const until = chunk[j + 1] ? chunk[j + 1].s : end;
262
+ const t0 = Math.max(start, w.s - 1 / 30);
263
+ tl.fromTo(s, { opacity: 0, y: 30, scale: 0.7 }, { opacity: 1, y: 0, scale: 1, duration: 0.16, ease: "back.out(2.4)" }, t0);
264
+ tl.set(s, { color: "#f7a93b" }, t0);
265
+ tl.set(s, { color: "#efe6d6" }, until);
266
+ });
267
+ });
268
+
269
+ window.__timelines["main"] = tl;
270
+ </script>
271
+ </body>
272
+ </html>
@@ -0,0 +1,10 @@
1
+ {
2
+ "name": "tiktok-explainer-video",
3
+ "private": true,
4
+ "type": "module",
5
+ "scripts": {
6
+ "dev": "npx --yes hyperframes@0.8.176 preview",
7
+ "check": "npx --yes hyperframes@0.8.176 check"
8
+ },
9
+ "devDependencies": { "@hyperframes/core": "0.8.176" }
10
+ }
@@ -0,0 +1,60 @@
1
+ # Canvas films: a camera over one large canvas
2
+
3
+ A preset whose `style.json` has `"engine": "canvas"` (bundled: `film-explainer-canvas`) builds the film with
4
+ `canvas.html` instead of `film.html`. The whole video is one large canvas of elements. Each beat moves a camera over
5
+ it, and acts on the elements, timed to the narration. Everything else is a normal film: `lines.json`, `vo.py`,
6
+ `words.json`, kinetic captions, music, loudness, `make_film.py --render`. 9:16 only. Worked example:
7
+ [`examples/canvas-film/`](../examples/canvas-film/). It has the pixel-art sources: run `pixel.py` on each `.txt` first.
8
+
9
+ ## film.json
10
+
11
+ ```json
12
+ "canvas": { "w": 3400, "h": 7600, "elements": [ { "id": "basa", "kind": "text", "x": 170, "y": 320, "size": 150, "text": "BASA-BASI*?*" } ] },
13
+ "mascot": "cat.png",
14
+ "beats": [ { "vo": "v01", "cam": { "to": "basa", "zoom": 1.0 }, "do": [ { "act": "pop", "el": "basa", "at": "word:basa" } ] } ]
15
+ ```
16
+
17
+ Coordinates are canvas pixels (the screen is 1080×1920 at zoom 1). `x`/`y` is an element's top-left. Any element
18
+ takes `rot` (degrees) and `hidden: true` (invisible until a `pop` or `fade` shows it).
19
+
20
+ | kind | fields |
21
+ |---|---|
22
+ | `text` | `text` (`*word*` = accent, `\n` = new line), `size`, `font` `head`/`serif`/`mono`, `color` `fg`/`accent`/`muted`/`red`, `w` (wrap width), `align` |
23
+ | `img` | `img` (a file in the video folder), `w`, `h`, `frame` (cream-framed card), `pixel` (sharp pixel art), `fit`, `chip` (mono tag), `label` (serif line under it) |
24
+ | `card` | a framed card with big text: `text`, `w`, `h`, `size`, `fill` (`accent` for an orange card), `color` |
25
+ | `strip` | a filmstrip: `frames` (each `{img}` or `{text}`, plus `tc` timecode), `fw`, `fh`, `gap`, `pixel`, `playhead` (frame index; adds a red playhead). Its cells are targets named `<id>/<n>` |
26
+ | `numeral` | a giant outlined digit: `value`, `size`, `w`; `fill` fills it, `morph` swaps it to the next value |
27
+ | `tape` | an orange banner: `text`, `w`, `size`, `stamp` (red stamp text that slams on with `stamp`) |
28
+
29
+ ## Camera (`cam`, at the beat's start)
30
+
31
+ `{"to": "<id>" | [x, y], "zoom": 1.2, "dur": 0.8, "ease": "power3.inOut", "offset": [dx, dy]}`. The target's centre
32
+ lands at 42% of the screen height, above the captions. Without `zoom`, the camera fits the element. `dur: 0` cuts.
33
+ A beat with no `cam` holds the frame.
34
+
35
+ ## Actions (`do`)
36
+
37
+ Each action has `at`: seconds from the beat's start, or `"word:<w>"`, the moment the beat's first word starting with `<w>`
38
+ is spoken. Every action carries a sound (in brackets); `"sfx": ""` silences it, and `"vol"` sets its level.
39
+
40
+ - `move` (whoosh): `el` goes to `to` (an id or `[x, y]`, centre to centre) over `dur`. `arc` lifts it along a curve and `lift` scales it mid-flight. `follow: true` makes the camera ride along, with an optional `zoom`.
41
+ - `pop` (pop): scale in from nothing.
42
+ - `fade`: to `to` (default 1) over `dur`.
43
+ - `glow`: an orange ring and a slight scale-up.
44
+ - `scrub` (tick): a strip's playhead from frame `from` to `to` over `dur`, showing each frame's `tc`.
45
+ - `fill` (reveal): the numeral fills with orange.
46
+ - `morph` (shutter): the numeral swaps to `to` and fills again (`fill: false` keeps the outline).
47
+ - `stamp` (stamp): a tape slaps on, then its stamp slams. Give the tape `hidden: true`.
48
+ - `shake`: a short camera shake.
49
+
50
+ ## Choreographing a video
51
+
52
+ - One idea per beat; the camera moves at the start of every beat, so a scene changes every 2–4 s. Add actions
53
+ inside long lines so something moves about every 1.5–2.5 s.
54
+ - Lay the canvas out as the story's map: sections top to bottom, about 1500 px apart, so a wide shot of one section
55
+ does not show the next. Keep each section within roughly 1080/zoom by 1100/zoom canvas pixels around its centre.
56
+ - Reuse elements across beats (pan along the same strip, carry a card from one section into the next). Continuity is
57
+ what makes it feel like one camera, not a slideshow.
58
+ - Put actions on the spoken word they illustrate (`word:`), not on round seconds.
59
+ - Check framing with `npx --yes hyperframes@0.8.176 snapshot --at <s>,<s>` in `videos/<name>/film` before rendering.
60
+ - Pictures: the user's assets, else pixel art (`pixel.py`), else Wikimedia. Credit them in `CREDITS.txt`.
@@ -0,0 +1,107 @@
1
+ # Presets
2
+
3
+ A preset is a folder. `make_tiktok.py` finds it by the name in the video's `config.json` (`"preset"`),
4
+ looking in this order and taking the first folder that has an `index.html`:
5
+
6
+ 1. `presets/<name>/` in the project folder — styles for this project.
7
+ 2. `$KAIZEN_VIDEO_PRESETS/<name>/`, default `~/.kaizen/video-presets/<name>/` — your own styles, for every project.
8
+ 3. `<skill>/presets/<name>/` — the bundled ones.
9
+
10
+ A local preset with a bundled name overrides the bundled one. An unknown name stops the build and lists
11
+ every preset it can see. Nothing is registered anywhere: adding a folder is adding a preset.
12
+
13
+ ## What goes in the folder
14
+
15
+ | File | Required | Notes |
16
+ |---|---|---|
17
+ | `index.html` | yes | The HyperFrames composition template. |
18
+ | `package.json` | yes | Pins `@hyperframes/core` (copy one from a bundled preset). |
19
+ | `README.md` | yes | Look, motion, card types, sounds and config keys, for whoever picks a style. |
20
+ | `CREDITS.txt` | yes | Source, author and license of every font and sound file the preset uses, copied into every render's credits. Credit a preset's own music as a line `- <name>.mp3: <title, author, license>`; the render credits only the track the video uses, looked up here and then in the skill's `assets/CREDITS.txt`. |
21
+ | `assets/sfx/*.wav` | yes | Sound effects, 48 kHz, any WAV encoding. Durations are read from the files with ffprobe. |
22
+ | `assets/fonts/*.ttf` | no | Falls back to the skill's `assets/fonts/` (Montserrat, Fredoka, Special Elite). |
23
+ | `assets/music/*.mp3` | no | Falls back to the skill's `assets/music/` (`lights`, `investigations`, `sunny`). |
24
+ | `tools/carve.mjs`, `hyperframes.json` | no | Fall back to the skill's copies. |
25
+
26
+ A file in the preset always wins over the shared one with the same name, so a preset can replace a font or
27
+ a track without touching the others.
28
+
29
+ ## Template contract
30
+
31
+
32
+ `make_tiktok.py` fills these in `index.html`; keep them:
33
+
34
+ - `{{DURATION}}`, `{{VIDEO_DURATION}}`, `{{VIDEO}}`, `{{MUSIC_VOLUME}}`
35
+ - `{{HOOK_1}}`, `{{HOOK_2}}`, `{{HOOK_SUB}}`
36
+ - `<!-- SFX:BEGIN -->` — where the sound-effect `<audio>` tags are inserted.
37
+
38
+ The composition also reads `captions.js` (`window.CAPTIONS`, `window.SEG_STARTS`, `window.BEATS`), and its
39
+ voice element must have the id `a-roll` and the music bed the id `music`, because the music is carved around
40
+ the voice by those ids.
41
+
42
+ Sounds the script places itself: `shutter` (every card), `stamp` (a beat with `"stamp"`), `reveal` (each
43
+ `item`) and `ending` (the `end` beat). Any other wav in `assets/sfx/` can be used as a reaction in the
44
+ config (`{"sfx": "<file name>", "word", "after", "offset", "volume"}`). Keep peaks around −6.5 to −8.5 dBFS.
45
+
46
+ ## Adding one
47
+
48
+ 1. Copy the closest preset to the project's `presets/<style>/` (or `~/.kaizen/video-presets/<style>/`).
49
+ 2. Change `index.html` and the assets, update `README.md`, and write `CREDITS.txt` for every file you add.
50
+ 3. Set `"preset": "<style>"` in a video's config and build it.
51
+
52
+ To ship it to everyone who installs kaizen, copy the folder into this skill's `presets/` in the kaizen
53
+ repository. Move any music or font another preset could use into the shared `assets/`, credit it in
54
+ `assets/CREDITS.txt`, and keep only the preset's own files in its folder: every byte here goes into the
55
+ kaizen package.
56
+
57
+ # Film presets (from scratch)
58
+
59
+ `make_film.py` finds a film preset by the folder holding `style.json` (same three places as above), so the two kinds never collide. Bundled: `film-cinematic-drama`, `film-promo-booth`, `film-fun-energetic`, `film-viral-social`. Each works in 9:16 and 16:9; the `window` and `card` layouts fall back to full-bleed in 9:16.
60
+ | preset | use for | look & motion | audio | captions | loudness |
61
+ |---|---|---|---|---|---|
62
+ | cinematic-drama | pitch opener, brand film | dark, full-bleed photos, slow push-in, rise text, grain + vignette, fades | quiet music, hit on reveal, riser into the question, room tone | subtitle bar | −16 |
63
+ | promo-booth | exhibition loop, deck-faithful promo (the friend's style) | photo in a framed window beside the text, wipes, slide-in text, staged builds | whoosh on cuts, tick on titles, slightly louder music | subtitle bar | −16 |
64
+ | fun-energetic | social posts, parents, events | cream background, rounded photo cards that bounce in, pop text, light leaks | bright track (Carefree), pops and a chime | subtitle bar | −14 |
65
+ | explainer-canvas | TikTok explainers that move like a motion-graphics edit (9:16) | one canvas, camera pans, zooms and follows; filmstrip, numerals, tape and stamp (`references/canvas.md`) | whoosh, pop, tick, stamp | kinetic, lowercase | −14 |
66
+ | viral-social | TikTok / Reels / Shorts (9:16) | full-bleed, fast punch-in cuts, bold Inter, strong Ken Burns | Easy Lemon-type track, whooshes | kinetic 2–3 words, accent on the spoken word | −14 |
67
+
68
+ Pace: `lead` / `tail` = silence before and after each line. Drama 0.8/1.1, booth 0.45/0.7, fun 0.2/0.35, viral 0.05/0.2.
69
+
70
+ ## Template presets
71
+
72
+ `app-promo` is a template preset (`preset.json`, kind `template`): a whole HyperFrames film filled from a product brief, built by `make_promo.py`. See [`promo.md`](promo.md). The New video wizard offers it for a brief start, and the five footage presets (tiktok-explainer, tiktok-mystery, tiktok-cheerful, tiktok-scam-alert, educational-warning) for a footage start only: a footage preset edits the user's own recording, so a brief with one is refused. The film-* presets carry a `.hidden` file until the user approves a video made with them; they still build for existing videos.
73
+
74
+ ## Crossing over
75
+
76
+ A film preset works for a footage start too: the build script notices it and bridges. A footage preset is offered only for footage on the Video page (2026-10-26); the brief-to-footage bridge below still works when make_film.py is run by hand.
77
+
78
+ - **Footage with a film preset.** `make_tiktok.py` writes `videos/<name>/film-bridge/`: the cut (`video` in the
79
+ config) re-encoded silent as `footage.mp4`, its sound as `v01.mp3`, the caption words as `words.json`, and a
80
+ `film.json` with one `footage` beat and `"style": {"pace": {"lead": 0, "tail": 0}}` so the voice stays on the lips.
81
+ It then runs `make_film.py` on that folder (passing `--render`), which writes `output/<name>/<preset>/` with the
82
+ .srt and thumbnail. Kept: the film style's grade, captions, music levels and loudness, and the config's `music`.
83
+ Dropped: the hook, the cold open and every card in `beats`.
84
+ - **A brief with a footage preset.** `make_film.py` builds the film in `film-viral-social` with no captions, no
85
+ music and no cut sounds, renders it to `videos/<name>/film/pass1.mp4` on every build, then writes
86
+ `videos/<name>/footage-bridge/config.json` (the film's words on that timeline, a jump cut at every scene,
87
+ `hook` from film.json or the first six words, `music` from film.json or `sunny`) and runs `make_tiktok.py` on
88
+ it. Pass 1 carries pictures only and the clip card is hidden (`"card": false`), so the template draws the words
89
+ as its own scenes. Each film scene opens on a headline scene after the 3 s hook (`title` with kick, title, sub
90
+ and picture; `stat` with its first value as the giant numeral; `question` with a giant `?`), then `photo` scenes
91
+ cycle the beat's `img` and `"pics"` at its phrase breaks, about every 2 s, with the captions on. `items` become
92
+ `item` rows and `cta` the `end` card. Under the hook, the first picture shows. A headline over 14 characters
93
+ moves to the serif line with a warning. film.json `"footage_beats"` (template beats, placed with
94
+ `"t"` seconds or `"word"`) replaces the mapping; `"mascot"` (a transparent PNG in the video folder) adds the
95
+ corner mascot. 9:16 only; no .srt. A build takes a render longer.
96
+
97
+ `film.json` `"style"` overrides keys of the preset's `style.json` for one film; a dict merges into the preset's.
98
+
99
+ ## Writing for each preset
100
+ - **drama**: full story arc, 70–110 s, long pauses allowed.
101
+ - **booth**: the deck's beats in order, 80–100 s, must make sense when joined mid-loop; real contacts on the CTA.
102
+ - **fun**: 35–50 s, playful lines ("Kenal rasanya?"), one problem montage, three quick benefits.
103
+ - **viral**: ≤ 30 s, line 1 is the hook (a sharp, relatable pain), product by second ~12, one CTA.
104
+
105
+ ## Adding a preset
106
+ Copy a `film-*` folder to `presets/<name>/` in the project and edit its `style.json` (no `index.html`: `film.html` is shared); fields: palette, fonts (any font file in `assets/film-fonts/` or the preset's `assets/fonts/`, named like `PlayfairDisplay.ttf`), pace, text (rise|slide|pop), transition (fade|wipe|punch),
107
+ layout (fullbleed|window|card), grade, captions (subtitle|kinetic|none), music levels, sfx names, kenburns, loudness.
@@ -7,8 +7,8 @@ Learned by comparing deck-to-video renders against richer productions . The exam
7
7
  "140 pesan", `keyboard`, `bell`), soft whoosh/tick on cuts, a hit on the reveal, a riser into the
8
8
  question. Music ducks under speech and only lifts at the reveal — never a dramatic swell unless
9
9
  the preset is drama.
10
- 2. **Captions**: always. Projectors and phones are often muted. Subtitle bar for 16:9, kinetic
11
- 2–3-word captions for 9:16. Captions come from `words.json`, so they follow the voice exactly.
10
+ 2. **Captions**: always. Projectors and phones are often muted. Subtitle bar (cinematic, booth, fun) or kinetic
11
+ 2–3-word captions (viral), in either shape. Captions come from `words.json`, so they follow the voice exactly.
12
12
  3. **Staged builds inside a beat**: numbers count up, list items arrive one by one with the voice,
13
13
  triptych panels arrive in turn. A whole slide appearing at once reads as a slideshow.
14
14
  4. **Directed voice**: emotion tag per line, low and slow through the problem, lift at the question,
@@ -0,0 +1,148 @@
1
+ # Product promos: template presets (app-promo)
2
+
3
+ A **template preset** is a whole HyperFrames film that fills itself from a product brief. It is used when
4
+ the user wants a video about their product: an app, a website, a tool. The first template preset is
5
+ `app-promo`, made from the kaizen launch video the user approved on 2026-10-26.
6
+
7
+ An app-promo video has these parts, in order:
8
+ - a two-second hook;
9
+ - the product's name;
10
+ - the product used for real, one task per step, each step with one caption, tap marks and camera
11
+ punch-ins;
12
+ - an end card with the logo, the tagline and the call to action.
13
+
14
+ Everything on screen is the real product. Nothing is mocked up.
15
+
16
+ A template preset is a folder with `preset.json` (`"kind": "template"`), a `template/` HyperFrames project,
17
+ `README.md` and `CREDITS.txt`. The Video page lists it for a from-scratch start.
18
+
19
+ ## 1. Learn the product, write the brief
20
+
21
+ Read the product before asking anything:
22
+ - its site or README;
23
+ - its `manifest.webmanifest`, for name, description and theme colour;
24
+ - its logo files and CSS colours.
25
+
26
+ Ask only what you cannot find:
27
+ - where it runs;
28
+ - a safe account;
29
+ - the tasks worth showing.
30
+
31
+ Then write `videos/<name>/promo.json`:
32
+
33
+ ```json
34
+ {
35
+ "product": "Notula", "url": "notula.huseinf.my.id",
36
+ "tagline": "Record & Summarize", "cta": "notula.huseinf.my.id",
37
+ "hook": ["You talked", "for an hour.", "Now what?"],
38
+ "brand": { "logo": "logo.png", "bg": "#f4f3ff", "ink": "#16133a", "accent": "#4b44cf", "font": "Inter" },
39
+ "music": "sunny",
40
+ "steps": [
41
+ { "clip": "list-web", "with": "list", "caption": "Every meeting, / *recorded.*", "from": 0.3, "to": 4.2 },
42
+ { "clip": "meeting", "caption": "Who said what, / *transcribed.*", "from": 0.5, "to": 8.6 }
43
+ ]
44
+ }
45
+ ```
46
+
47
+ - **Words.** Tagline, CTA and claims use the product's own words. The hook can be a line of yours, but it
48
+ makes no claim. Captions:
49
+ - hold at most 6 words;
50
+ - break lines with `/`;
51
+ - mark the one accent word with `*word*`.
52
+
53
+ Say each idea once: no caption repeats another.
54
+ - **Brand.** It comes from the product:
55
+ - its theme colour as the accent;
56
+ - its background, or the logo's ground, as `bg`;
57
+ - its ink.
58
+
59
+ A light brand gets a light ground; the device frames follow it.
60
+ - **Devices follow where the product runs.** Each step shows its clip's device:
61
+ - a phone for a mobile app or PWA;
62
+ - a browser window with the real URL for a web app;
63
+ - a titled window for a native desktop app, which needs the user's own recording.
64
+
65
+ `"with"` puts a second clip of the same task on another device beside it: laptop and phone together,
66
+ for a product that runs on both. Use it once, early, to say "everywhere". Then stay on the device where
67
+ the task reads best.
68
+
69
+ ## 2. Record
70
+
71
+ Write `videos/<name>/record.json`. Each clip lists its device and its steps:
72
+
73
+ - `["tap", "text:Label" | css]`
74
+ - `["type", css, "words"]`
75
+ - `["key", "Enter"]`
76
+ - `["scroll", px]`
77
+ - `["wait", ms]`
78
+ - `["goto", "/path"]`
79
+ - `"prep"`: steps run before filming starts, such as a sign-in. Clips share one browser, so sign in on the
80
+ first clip only.
81
+
82
+ Then run:
83
+
84
+ ```
85
+ node $S/record.mjs videos/<name> # writes rec/<clip>.mp4 + rec/<clip>.json (device, taps)
86
+ ```
87
+
88
+ **Privacy:** everything on screen is filmed. Never point the recorder at a real account with real data.
89
+
90
+ | Product | What to do |
91
+ |---|---|
92
+ | has a demo account | use it |
93
+ | open-source or in ~/Projects | run a local copy with its own empty database and seed sample data made for the video |
94
+ | kaizen itself | a sandboxed board: `HOME=<scratch>/home` with `projects`/`projects_dir` pointing at a scratch copy of `.kaizen` |
95
+
96
+ Watch out for a local copy:
97
+ - **Laravel:** delete `bootstrap/cache/config.php` before any `artisan` command, or it still points at the
98
+ real database.
99
+ - **Check the database first:** confirm the copy's own database path
100
+ (`php artisan tinker --execute 'echo config("database.connections.sqlite.database");'`) before writing
101
+ anything.
102
+ - **Sample content:** content made for the video (demo meetings, sample cards) is illustrative. Say so in
103
+ the delivery note.
104
+
105
+ For a native app the recorder cannot drive, put the user's screen recording at `rec/<clip>.mp4` and write
106
+ `rec/<clip>.json` yourself: `{"device": "phone"|"app", "cssW", "cssH", "seconds", "taps": []}`.
107
+
108
+ ## 3. Build, look, render
109
+
110
+ ```
111
+ python3 $S/make_promo.py videos/<name> # project in videos/<name>/promo/, check, promo/check/sheet.jpg
112
+ python3 $S/make_promo.py videos/<name> --render # output/<name>/app-promo/<name>.mp4 + CREDITS.txt, -14 LUFS
113
+ ```
114
+
115
+ Pick each step's `from`/`to` from the tap times in `rec/<clip>.json`. A step starts just before its first
116
+ tap and ends after the UI has answered.
117
+
118
+ Look at `promo/check/sheet.jpg` before rendering. Check for:
119
+ - captions clear of the device;
120
+ - each step's screen showing what its caption says;
121
+ - no private data;
122
+ - no repeated idea.
123
+
124
+ Punch-ins are automatic: on each tap the UI then has time to act on. Set `"punch": []` on a step to turn
125
+ them off, or give your own list.
126
+
127
+ ## 4. Adding the next approved preset
128
+
129
+ A new look becomes a preset only after the user approves a video made with it:
130
+
131
+ 1. Agree a reference with the user: a HyperFrames showcase film or any video they like. Study it frame by
132
+ frame.
133
+ 2. Make one real video in that look with the `/hyperframes` skill workflow:
134
+ - `SPEC.md`;
135
+ - one scene per sub-composition;
136
+ - real material;
137
+ - `hyperframes check`;
138
+ - a snapshot review.
139
+
140
+ Revise until the user says it meets their standard.
141
+ 3. Turn the approved project into `presets/<name>/template/`:
142
+ - replace its product text, colours and media with placeholders the build step fills;
143
+ - add `preset.json` and `CREDITS.txt`;
144
+ - add a build script, or extend `make_promo.py` when the scene contract is the same.
145
+ 4. Build it on a second product before listing it. A look that only works for one product is not a preset
146
+ yet.
147
+
148
+ Unapproved presets carry a `.hidden` file: they still build, but the New video wizard does not offer them.