@scenerok/sdk 0.26.0 → 0.28.0

package/skills/scenerok/references/repertoire.md

@@ -0,0 +1,1493 @@
+# Repertoire
+
+What each tool looks like, what it is for, and what it fights, so you can choose from a
+beat's job instead of from a menu. How to choose: `choosing.md`. Syntax and params live in
+each family's reference. Generated from `src/lib/catalog/tool-guide/`; edit the records there.
+
+## Find tools by job
+
+| Job | Tools |
+| --- | --- |
+| **establish**: set the place, mood or subject | `animations.ios26_liquid_glass(…)`, `animations.macos_tahoe_liquid_glass(…)`, `animations.text_neon_flicker(…)`, `motion.fadeIn(…)`, `motion.riseIn(…)`, `tr.dissolve()`, `tr.blur()`, `filter "monochrome"`, `filter "sepia"`, `push`, `made-background`, `xai.image(…)`, `xai.imagine(…)`, `xai.imageToVideo(…)`, `xai.referenceToVideo(…)`, `cf.image(…)`, `cf.video(…)`, `cf.imageToVideo(…)`, `cf.referenceToVideo(…)` |
+| **announce**: a headline, launch or piece of news | `animations.blue_sweater_intro_video(…)`, `animations.code_particle_assemble(…)`, `animations.liquid_glass_notification(…)`, `animations.lower_third_bild(…)`, `animations.macos_notification(…)`, `animations.news_ticker(…)`, `animations.text_glitch_title(…)`, `animations.text_gradient_sweep(…)`, `animations.text_kinetic_words(…)`, `animations.text_line_stack(…)`, `animations.text_scramble_decode(…)`, `animations.text_word_cascade(…)`, `animations.ui_3d_reveal(…)`, `animations.vpn_youtube_spot(…)`, `text`, `text+area`, `text+stagger`, `motion.riseIn(…)` |
+| **name**: identify a person, product or place | `animations.blue_sweater_intro_video(…)`, `animations.lower_third(…)`, `animations.lower_third_bild(…)`, `animations.lt_accent_underline(…)` and 8 variants, `animations.lt_kicker_name(…)`, `animations.yt_lower_third(…)`, `text`, `text+plate`, `function` |
+| **list**: several points in sequence | `animations.text_line_stack(…)`, `text`, `text+area`, `motion.fadeIn(…)`, `motion.slideX(…)`, `motion.slideY(…)`, `motion.riseIn(…)` |
+| **count**: a number that matters | `animations.apple_money_count(…)`, `animations.text_counter_stat(…)`, `text`, `text+plate`, `motion.popIn(…)` |
+| **compare**: before and after, A against B | `animations.code_diff(…)`, `animations.code_morph(…)`, `Overlay`, `grid` |
+| **quote**: someone's words | `animations.reddit_post(…)`, `animations.text_typewriter_quote(…)`, `animations.x_post(…)`, `text`, `motion.typewriter(…)` |
+| **code**: show code or a command | `animations.code_3d_extrude(…)`, `animations.code_diff(…)`, `animations.code_highlight(…)`, `animations.code_morph(…)`, `animations.code_particle_assemble(…)`, `animations.code_scroll(…)`, `animations.code_shader_dissolve(…)`, `animations.code_snippet_apple_terminal_basic(…)` and 11 variants, `animations.code_snippet_dark_2026(…)` and 11 variants, `animations.code_snippet_flight(…)`, `animations.code_typing(…)`, `animations.text_scramble_decode(…)`, `motion.typewriter(…)`, `filter "text_cursor"` |
+| **prove**: real evidence: a UI, a post, a rating, footage | `animations.app_showcase(…)`, `animations.code_snippet_dark_2026(…)` and 11 variants, `animations.macos_notification(…)`, `animations.reddit_post(…)`, `animations.spotify_card(…)`, `animations.vfx_iphone_device(…)`, `animations.x_post(…)`, `Overlay`, `page-images`, `screenshot`, `screen-recording` |
+| **demo**: show the thing in use | `animations.app_showcase(…)`, `animations.code_snippet_apple_terminal_basic(…)` and 11 variants, `animations.custom_html(…)`, `animations.liquid_glass_context_menu(…)`, `animations.liquid_glass_media_controls(…)`, `animations.liquid_glass_notification(…)`, `animations.liquid_glass_widgets(…)`, `animations.macos_tahoe_liquid_glass(…)`, `animations.ui_3d_reveal(…)`, `animations.vfx_iphone_device(…)`, `animations.vpn_youtube_spot(…)`, `placement`, `Overlay`, `grid`, `page-images`, `screenshot`, `screen-recording`, `xai.imageToVideo(…)`, `xai.referenceToVideo(…)`, `cf.imageToVideo(…)`, `lottie.file(…)` |
+| **emphasize**: punch one word or moment | `animations.blend_caption(…)`, `animations.code_3d_extrude(…)`, `animations.code_highlight(…)`, `animations.custom_html(…)`, `animations.text_counter_stat(…)`, `animations.text_glitch_title(…)`, `animations.text_kinetic_words(…)`, `animations.text_neon_flicker(…)`, `text+stagger`, `motion.popIn(…)`, `motion.swingIn(…)`, `motion.glitchIn(…)`, `filter "glitch"`, `Mask` |
+| **brand**: logo, sign-off, identity | `animations.instagram_follow(…)`, `animations.logo_outro(…)`, `animations.tiktok_follow(…)`, `motion.float(…)`, `Mask`, `function`, `lottie.file(…)` |
+| **cta**: tell the viewer what to do next | `animations.instagram_follow(…)`, `animations.logo_outro(…)`, `animations.tiktok_follow(…)`, `animations.yt_lower_third(…)`, `text`, `text+plate`, `motion.popIn(…)` |
+| **caption**: put speech on screen | `animations.blend_caption(…)`, `text+area`, `captions`, `xai.tts(…)` |
+| **transition**: move from one beat to the next | `motion.fadeOut(…)`, `motion.slideX(…)`, `tr.dissolve()`, `tr.push()`, `tr.cover()`, `tr.radial()`, `tr.grid()`, `tr.scale()`, `tr.cube()`, `tr.blur()`, `tr.distortion()`, `tr.destruction()`, `tr.light()`, `tr.mechanical()`, `tr.wipe()`, `tr.cinematic_zoom()`, `tr.whip_pan()`, `tr.light_leak()`, `tr.flash()`, `tr.warp_morph()`, `tr.domain_warp()`, `tr.chromatic_split()`, `tr.lens()`, `tr.glitch()`, `tr.swirl()`, `tr.thermal()`, `tr.ripple()`, `tr.iris()`, `tr.burn()`, `tr.shatter()`, `tr.liquid()`, `filter "portal"` |
+| **grade**: set the colour and finish | `filter "cdl"`, `filter "lut"`, `filter "vignette"`, `filter "contrast"`, `filter "saturation"`, `filter "brightness"`, `filter "monochrome"`, `filter "sepia"`, `blend` |
+| **texture**: add surface, energy or atmosphere | `animations.code_shader_dissolve(…)`, `animations.custom_html(…)`, `animations.ios26_liquid_glass(…)`, `animations.liquid_glass_context_menu(…)`, `motion.glitchIn(…)`, `motion.float(…)`, `tr.thermal()`, `filter "blur"`, `filter "chromatic"`, `filter "glitch"`, `filter "liquid_glass"`, `filter "magnetic"`, `filter "portal"`, `filter "text_cursor"`, `push`, `blend`, `Mask`, `motion_blur`, `image-sequence`, `made-background`, `xai.image(…)`, `xai.imagine(…)`, `cf.image(…)`, `cf.video(…)`, `lottie.file(…)` |
+| **source**: get a picture, clip or sound | `page-images`, `screenshot`, `screen-recording`, `grabFrame`, `image-sequence`, `xai.image(…)`, `xai.imagine(…)`, `xai.imageToVideo(…)`, `xai.referenceToVideo(…)`, `xai.extendVideo(…)`, `cf.image(…)`, `cf.video(…)`, `cf.imageToVideo(…)`, `cf.referenceToVideo(…)`, `cf.extendVideo(…)`, `up.upscale(…)` |
+| **edit**: cut, time, layer or frame footage | `filter "premultiply"`, `Trim`, `Crop`, `placement`, `function`, `grabFrame` |
+| **sound**: voice or music | `animations.spotify_card(…)`, `duck_under`, `xai.tts(…)`, `eleven.music(…)` |
+
+## Animation blocks
+
+Syntax and params: animations-catalog.md.
+
+### `animations.app_showcase(…)`
+
+Three phone mock-ups fanned on a pale green set, showing your app screenshot.
+
+- **Looks:** Soft sage background, three phones tilted in a fan, a dark profile card floating over them. The phones drift and settle; the eye lands on the centre phone. Light, airy, product-marketing style.
+- **For:** demo, prove. **Fights:** Dark, moody videos (it is bright and pastel); screenshots in landscape (the phones are portrait).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 6 s default. Takes imageUrl, userName, userRole, tagline, accentColor. Image asset via imageUrl. Demo block: most of what it shows is fixed artwork; only the listed params change. A portrait screenshot (imageUrl) reads best.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__app_showcase.mp4
+
+### `animations.apple_money_count(…)`
+
+A large dollar amount counting up on white.
+
+- **Looks:** Plain white frame, a bold black amount in the centre that holds at $0, counts up and lands with a small bounce at about 3.2 s; nothing else. Very clean, very quiet.
+- **For:** count. **Fights:** Dark-themed videos (it is a white slab), non-money numbers.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes amount, currency, accentColor. One amount. Use `text_counter_stat` for anything that is not money or for a dark palette.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__apple_money_count.mp4
+
+### `animations.blend_caption(…)`
+
+One huge word or line in difference blend, so it inverts whatever is behind it.
+
+- **Looks:** A 190 px, weight-900 line across the frame drawn with a difference blend: white over dark footage, dark over bright footage, colour-inverted over colour. The letters change as the picture moves under them.
+- **For:** emphasize, caption. **Fights:** Long words in 9:16 (the catalog sample runs off the frame), mid-grey footage (difference gives low contrast).
+- **Fit:** Inline overlay: scales with the frame. 5 s default. Takes text, color. One or two short words. Inline overlay: it scales with the frame rather than letterboxing.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__blend_caption.mp4
+
+### `animations.blue_sweater_intro_video(…)`
+
+A creator intro: a typed "Introducing" line, a name, a bio and an avatar on warm off-white.
+
+- **Looks:** Warm cream background, grey "Introducing" typed in the middle with a cursor, then the creator name in a highlighted box, then the bio and avatar. Calm, editorial, 12 s long.
+- **For:** name, announce. **Fights:** Fast edits (it needs its 12 s), dark palettes.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 12 s default. Takes headline, creatorName, creatorHandle, creatorBio, avatarUrl. Image asset via avatarUrl. Demo block: most of what it shows is fixed artwork; only the listed params change. headline, creatorName, creatorHandle, creatorBio and avatarUrl are yours.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__blue_sweater_intro_video.mp4
+
+### `animations.code_3d_extrude(…)`
+
+Your code as a lit 3D slab that turns in space.
+
+- **Looks:** Dark frame; a single code line rendered on a thick slab, tilted in perspective with a light sweep, rotating toward the viewer until it reads flat.
+- **For:** code, emphasize. **Fights:** More than one or two lines, anything that needs to be read in detail.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 8 s default. Takes code, lang, theme, filename. WebGL: heavier to render than the 2D code blocks. One short line.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_3d_extrude.mp4?v=1fb913bd
+
+### `animations.code_diff(…)`
+
+A before/after code change shown as a diff.
+
+- **Looks:** Editor window on a dark navy and green glow, under a "+1 −1" count in green and red. The old line appears in red with a minus, then the new line arrives in green with a plus and a cyan outline. With keep_removed the red line stays, so the frame reads as a before/after. In 9:16 it uses a portrait layout in the upper half of the frame (checked in render 536); the lower half stays empty.
+- **For:** code, compare. **Fights:** Big multi-file changes; changes where the old line is not worth seeing.
+- **Fit:** Has its own 9:16 layout. 6 s default. Takes from, to, lang, theme, filename, label, keep_removed. A few changed lines; a line of ~36 characters fits the 9:16 card. The catalog preview predates the portrait layout.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_diff.mp4
+
+### `animations.code_highlight(…)`
+
+A code window that sweeps a highlight across one line.
+
+- **Looks:** Dark editor window on a navy glow; the code fades in, then a highlight bar sweeps under the line that matters.
+- **For:** code, emphasize. **Fights:** Long files; a second highlight competing for attention.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes code, lang, theme, filename. A few lines; the highlight lands on one.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_highlight.mp4
+
+### `animations.code_morph(…)`
+
+Code that morphs from one version to another token by token.
+
+- **Looks:** Dark editor window; the first snippet sits still, then tokens slide, fade and rearrange into the second snippet. Unchanged tokens stay put, so the eye follows the change.
+- **For:** code, compare. **Fights:** Two snippets with little in common (it turns into a cross-fade).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 7 s default. Takes from, to, lang, theme, filename, label, keep_removed. Short snippets of similar shape.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_morph.mp4
+
+### `animations.code_particle_assemble(…)`
+
+Code that assembles from a cloud of particles.
+
+- **Looks:** Dark frame full of drifting glowing dots that fly together into a line of code, which then sits sharp in the centre.
+- **For:** code, announce. **Fights:** Busy footage behind it, motion-sensitive viewers, dense code.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 8 s default. Takes code, lang, theme, filename. WebGL particles: heavier render. One short line.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_particle_assemble.mp4?v=5666582a
+
+### `animations.code_scroll(…)`
+
+A code window that scrolls to a target line.
+
+- **Looks:** Dark editor window; the file scrolls smoothly and stops on a line that lights up.
+- **For:** code. **Fights:** Short snippets (nothing to scroll), voiceover that needs a still frame.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 6 s default. Takes code, lang, theme, filename. Longer files; the scroll is the point.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_scroll.mp4
+
+### `animations.code_shader_dissolve(…)`
+
+Code that dissolves in or out through a noise shader.
+
+- **Looks:** Dark frame; a code line dissolves in through a noise shader and resolves into crisp text. The catalog preview stays dark for its 3 s sample, so render it before relying on it.
+- **For:** code, texture. **Fights:** Reading-heavy beats; it is a reveal, not a reading surface.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 7 s default. Takes code, lang, theme, filename. WebGL: heavier render. One short line.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_shader_dissolve.mp4
+
+### `animations.code_snippet_apple_terminal_basic(…)`
+
+A macOS Terminal window (Basic (white) profile) that types a command and prints its output.
+
+- **Looks:** A Terminal window centred on a Basic (white) backdrop with the window chrome (traffic lights, title). The prompt sits top-left, the command types character by character, then the output appears. Mostly still apart from the typing and caret.
+- **For:** code, demo. **Fights:** Long multi-line output, small phones (16:9 design only, so in 9:16 the window shrinks to about half width).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 12 s default. Takes command, output, prompt, title. One command and a few lines of output. 12 s default leaves room for the typing to finish.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_apple_terminal_basic.mp4
+
+### `animations.code_snippet_apple_terminal_clear_dark(…)`
+
+A macOS Terminal window (Clear Dark profile) that types a command and prints its output.
+
+- **Looks:** A Terminal window centred on a Clear Dark backdrop with the window chrome (traffic lights, title). The prompt sits top-left, the command types character by character, then the output appears. Mostly still apart from the typing and caret.
+- **For:** code, demo. **Fights:** Long multi-line output, small phones (16:9 design only, so in 9:16 the window shrinks to about half width).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 12 s default. Takes command, output, prompt, title. One command and a few lines of output. 12 s default leaves room for the typing to finish.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_apple_terminal_clear_dark.mp4
+
+### `animations.code_snippet_apple_terminal_clear_light(…)`
+
+A macOS Terminal window (Clear Light profile) that types a command and prints its output.
+
+- **Looks:** A Terminal window centred on a Clear Light backdrop with the window chrome (traffic lights, title). The prompt sits top-left, the command types character by character, then the output appears. Mostly still apart from the typing and caret.
+- **For:** code, demo. **Fights:** Long multi-line output, small phones (16:9 design only, so in 9:16 the window shrinks to about half width).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 12 s default. Takes command, output, prompt, title. One command and a few lines of output. 12 s default leaves room for the typing to finish.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_apple_terminal_clear_light.mp4
+
+### `animations.code_snippet_apple_terminal_grass(…)`
+
+A macOS Terminal window (Grass (green on black) profile) that types a command and prints its output.
+
+- **Looks:** A Terminal window centred on a Grass (green on black) backdrop with the window chrome (traffic lights, title). The prompt sits top-left, the command types character by character, then the output appears. Mostly still apart from the typing and caret.
+- **For:** code, demo. **Fights:** Long multi-line output, small phones (16:9 design only, so in 9:16 the window shrinks to about half width).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 12 s default. Takes command, output, prompt, title. One command and a few lines of output. 12 s default leaves room for the typing to finish.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_apple_terminal_grass.mp4
+
+### `animations.code_snippet_apple_terminal_homebrew(…)`
+
+A macOS Terminal window (Homebrew (green on black) profile) that types a command and prints its output.
+
+- **Looks:** A Terminal window centred on a Homebrew (green on black) backdrop with the window chrome (traffic lights, title). The prompt sits top-left, the command types character by character, then the output appears. Mostly still apart from the typing and caret.
+- **For:** code, demo. **Fights:** Long multi-line output, small phones (16:9 design only, so in 9:16 the window shrinks to about half width).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 12 s default. Takes command, output, prompt, title. One command and a few lines of output. 12 s default leaves room for the typing to finish.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_apple_terminal_homebrew.mp4
+
+### `animations.code_snippet_apple_terminal_man_page(…)`
+
+A macOS Terminal window (Man Page (pale yellow) profile) that types a command and prints its output.
+
+- **Looks:** A Terminal window centred on a Man Page (pale yellow) backdrop with the window chrome (traffic lights, title). The prompt sits top-left, the command types character by character, then the output appears. Mostly still apart from the typing and caret.
+- **For:** code, demo. **Fights:** Long multi-line output, small phones (16:9 design only, so in 9:16 the window shrinks to about half width).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 12 s default. Takes command, output, prompt, title. One command and a few lines of output. 12 s default leaves room for the typing to finish.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_apple_terminal_man_page.mp4
+
+### `animations.code_snippet_apple_terminal_novel(…)`
+
+A macOS Terminal window (Novel (tan paper) profile) that types a command and prints its output.
+
+- **Looks:** A Terminal window centred on a Novel (tan paper) backdrop with the window chrome (traffic lights, title). The prompt sits top-left, the command types character by character, then the output appears. Mostly still apart from the typing and caret.
+- **For:** code, demo. **Fights:** Long multi-line output, small phones (16:9 design only, so in 9:16 the window shrinks to about half width).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 12 s default. Takes command, output, prompt, title. One command and a few lines of output. 12 s default leaves room for the typing to finish.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_apple_terminal_novel.mp4
+
+### `animations.code_snippet_apple_terminal_ocean(…)`
+
+A macOS Terminal window (Ocean (blue) profile) that types a command and prints its output.
+
+- **Looks:** A Terminal window centred on a Ocean (blue) backdrop with the window chrome (traffic lights, title). The prompt sits top-left, the command types character by character, then the output appears. Mostly still apart from the typing and caret.
+- **For:** code, demo. **Fights:** Long multi-line output, small phones (16:9 design only, so in 9:16 the window shrinks to about half width).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 12 s default. Takes command, output, prompt, title. One command and a few lines of output. 12 s default leaves room for the typing to finish.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_apple_terminal_ocean.mp4
+
+### `animations.code_snippet_apple_terminal_pro(…)`
+
+A macOS Terminal window (Pro (black) profile) that types a command and prints its output.
+
+- **Looks:** A Terminal window centred on a Pro (black) backdrop with the window chrome (traffic lights, title). The prompt sits top-left, the command types character by character, then the output appears. Mostly still apart from the typing and caret.
+- **For:** code, demo. **Fights:** Long multi-line output, small phones (16:9 design only, so in 9:16 the window shrinks to about half width).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 12 s default. Takes command, output, prompt, title. One command and a few lines of output. 12 s default leaves room for the typing to finish.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_apple_terminal_pro.mp4
+
+### `animations.code_snippet_apple_terminal_red_sands(…)`
+
+A macOS Terminal window (Red Sands (deep red) profile) that types a command and prints its output.
+
+- **Looks:** A Terminal window centred on a Red Sands (deep red) backdrop with the window chrome (traffic lights, title). The prompt sits top-left, the command types character by character, then the output appears. Mostly still apart from the typing and caret.
+- **For:** code, demo. **Fights:** Long multi-line output, small phones (16:9 design only, so in 9:16 the window shrinks to about half width).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 12 s default. Takes command, output, prompt, title. One command and a few lines of output. 12 s default leaves room for the typing to finish.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_apple_terminal_red_sands.mp4
+
+### `animations.code_snippet_apple_terminal_silver_aerogel(…)`
+
+A macOS Terminal window (Silver Aerogel (grey) profile) that types a command and prints its output.
+
+- **Looks:** A Terminal window centred on a Silver Aerogel (grey) backdrop with the window chrome (traffic lights, title). The prompt sits top-left, the command types character by character, then the output appears. Mostly still apart from the typing and caret.
+- **For:** code, demo. **Fights:** Long multi-line output, small phones (16:9 design only, so in 9:16 the window shrinks to about half width).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 12 s default. Takes command, output, prompt, title. One command and a few lines of output. 12 s default leaves room for the typing to finish.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_apple_terminal_silver_aerogel.mp4
+
+### `animations.code_snippet_apple_terminal_solid_colors(…)`
+
+A macOS Terminal window (Solid Colors (purple) profile) that types a command and prints its output.
+
+- **Looks:** A Terminal window centred on a Solid Colors (purple) backdrop with the window chrome (traffic lights, title). The prompt sits top-left, the command types character by character, then the output appears. Mostly still apart from the typing and caret.
+- **For:** code, demo. **Fights:** Long multi-line output, small phones (16:9 design only, so in 9:16 the window shrinks to about half width).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 12 s default. Takes command, output, prompt, title. One command and a few lines of output. 12 s default leaves room for the typing to finish.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_apple_terminal_solid_colors.mp4
+
+### `animations.code_snippet_dark_2026(…)`
+
+A VS Code editor window in the Dark 2026 theme that types out your code.
+
+- **Looks:** 16:9: a full editor (title bar, file tab, explorer sidebar, line numbers, status bar) on a Dark 2026 workbench, with a small header naming the theme. In 9:16 it switches to a portrait layout (checked in render 536): a small caps kicker and a 56 px file name at the top left, then a card in the upper half of the frame where lines slide in one by one under a moving highlight bar; at the end one line stays lit, the rest dim, and the card fades. The lower ~40 % of a 9:16 frame stays empty. The eye goes to the highlighted line.
+- **For:** code, prove. **Fights:** Long lines (in 9:16 they wrap, breaking the code shape), a busy background behind it, a voiceover reading the code aloud word for word.
+- **Fit:** Has its own 9:16 layout. 11 s default. Takes code, filename, lang. Code at ~15 px in the 16:9 editor reads small on a phone; the 9:16 card sets code at 40 px. About 10-14 lines fit. The catalog preview is blank, so judge it from a render.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_dark_2026.mp4
+
+### `animations.code_snippet_dark_modern(…)`
+
+A VS Code editor window in the Dark Modern theme that types out your code.
+
+- **Looks:** 16:9: a full editor (title bar, file tab, explorer sidebar, line numbers, status bar) on a Dark Modern workbench, with a small header naming the theme. In 9:16 it switches to a portrait layout (checked in render 536): a small caps kicker and a 56 px file name at the top left, then a card in the upper half of the frame where lines slide in one by one under a moving highlight bar; at the end one line stays lit, the rest dim, and the card fades. The lower ~40 % of a 9:16 frame stays empty. The eye goes to the highlighted line.
+- **For:** code, prove. **Fights:** Long lines (in 9:16 they wrap, breaking the code shape), a busy background behind it, a voiceover reading the code aloud word for word.
+- **Fit:** Has its own 9:16 layout. 11 s default. Takes code, filename, lang. Code at ~15 px in the 16:9 editor reads small on a phone; the 9:16 card sets code at 40 px. About 10-14 lines fit. The catalog preview is blank, so judge it from a render.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_dark_modern.mp4
+
+### `animations.code_snippet_dark_plus(…)`
+
+A VS Code editor window in the Dark+ theme that types out your code.
+
+- **Looks:** 16:9: a full editor (title bar, file tab, explorer sidebar, line numbers, status bar) on a Dark+ workbench, with a small header naming the theme. In 9:16 it switches to a portrait layout (checked in render 536): a small caps kicker and a 56 px file name at the top left, then a card in the upper half of the frame where lines slide in one by one under a moving highlight bar; at the end one line stays lit, the rest dim, and the card fades. The lower ~40 % of a 9:16 frame stays empty. The eye goes to the highlighted line.
+- **For:** code, prove. **Fights:** Long lines (in 9:16 they wrap, breaking the code shape), a busy background behind it, a voiceover reading the code aloud word for word.
+- **Fit:** Has its own 9:16 layout. 11 s default. Takes code, filename, lang. Code at ~15 px in the 16:9 editor reads small on a phone; the 9:16 card sets code at 40 px. About 10-14 lines fit. The catalog preview is blank, so judge it from a render.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_dark_plus.mp4
+
+### `animations.code_snippet_flight(…)`
+
+Code snippets that fly in and assemble into one file.
+
+- **Looks:** Dark editor window on a navy glow; fragments of code slide in from off-frame and lock into place line by line.
+- **For:** code. **Fights:** Code that should be read top to bottom from the start.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 6 s default. Takes code, lang, theme, filename. A few short lines.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_flight.mp4
+
+### `animations.code_snippet_high_contrast(…)`
+
+A VS Code editor window in the High Contrast (black and yellow) theme that types out your code.
+
+- **Looks:** 16:9: a full editor (title bar, file tab, explorer sidebar, line numbers, status bar) on a High Contrast (black and yellow) workbench, with a small header naming the theme. In 9:16 it switches to a portrait layout (checked in render 536): a small caps kicker and a 56 px file name at the top left, then a card in the upper half of the frame where lines slide in one by one under a moving highlight bar; at the end one line stays lit, the rest dim, and the card fades. The lower ~40 % of a 9:16 frame stays empty. The eye goes to the highlighted line.
+- **For:** code, prove. **Fights:** Long lines (in 9:16 they wrap, breaking the code shape), a busy background behind it, a voiceover reading the code aloud word for word.
+- **Fit:** Has its own 9:16 layout. 11 s default. Takes code, filename, lang. Code at ~15 px in the 16:9 editor reads small on a phone; the 9:16 card sets code at 40 px. About 10-14 lines fit. The catalog preview is blank, so judge it from a render.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_high_contrast.mp4
+
+### `animations.code_snippet_high_contrast_light(…)`
+
+A VS Code editor window in the High Contrast Light theme that types out your code.
+
+- **Looks:** 16:9: a full editor (title bar, file tab, explorer sidebar, line numbers, status bar) on a High Contrast Light workbench, with a small header naming the theme. In 9:16 it switches to a portrait layout (checked in render 536): a small caps kicker and a 56 px file name at the top left, then a card in the upper half of the frame where lines slide in one by one under a moving highlight bar; at the end one line stays lit, the rest dim, and the card fades. The lower ~40 % of a 9:16 frame stays empty. The eye goes to the highlighted line.
+- **For:** code, prove. **Fights:** Long lines (in 9:16 they wrap, breaking the code shape), a busy background behind it, a voiceover reading the code aloud word for word.
+- **Fit:** Has its own 9:16 layout. 11 s default. Takes code, filename, lang. Code at ~15 px in the 16:9 editor reads small on a phone; the 9:16 card sets code at 40 px. About 10-14 lines fit. The catalog preview is blank, so judge it from a render.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_high_contrast_light.mp4
+
+### `animations.code_snippet_light_2026(…)`
+
+A VS Code editor window in the Light 2026 theme that types out your code.
+
+- **Looks:** 16:9: a full editor (title bar, file tab, explorer sidebar, line numbers, status bar) on a Light 2026 workbench, with a small header naming the theme. In 9:16 it switches to a portrait layout (checked in render 536): a small caps kicker and a 56 px file name at the top left, then a card in the upper half of the frame where lines slide in one by one under a moving highlight bar; at the end one line stays lit, the rest dim, and the card fades. The lower ~40 % of a 9:16 frame stays empty. The eye goes to the highlighted line.
+- **For:** code, prove. **Fights:** Long lines (in 9:16 they wrap, breaking the code shape), a busy background behind it, a voiceover reading the code aloud word for word.
+- **Fit:** Has its own 9:16 layout. 11 s default. Takes code, filename, lang. Code at ~15 px in the 16:9 editor reads small on a phone; the 9:16 card sets code at 40 px. About 10-14 lines fit. The catalog preview is blank, so judge it from a render.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_light_2026.mp4
+
+### `animations.code_snippet_light_modern(…)`
+
+A VS Code editor window in the Light Modern theme that types out your code.
+
+- **Looks:** 16:9: a full editor (title bar, file tab, explorer sidebar, line numbers, status bar) on a Light Modern workbench, with a small header naming the theme. In 9:16 it switches to a portrait layout (checked in render 536): a small caps kicker and a 56 px file name at the top left, then a card in the upper half of the frame where lines slide in one by one under a moving highlight bar; at the end one line stays lit, the rest dim, and the card fades. The lower ~40 % of a 9:16 frame stays empty. The eye goes to the highlighted line.
+- **For:** code, prove. **Fights:** Long lines (in 9:16 they wrap, breaking the code shape), a busy background behind it, a voiceover reading the code aloud word for word.
+- **Fit:** Has its own 9:16 layout. 11 s default. Takes code, filename, lang. Code at ~15 px in the 16:9 editor reads small on a phone; the 9:16 card sets code at 40 px. About 10-14 lines fit. The catalog preview is blank, so judge it from a render.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_light_modern.mp4
+
+### `animations.code_snippet_light_plus(…)`
+
+A VS Code editor window in the Light+ theme that types out your code.
+
+- **Looks:** 16:9: a full editor (title bar, file tab, explorer sidebar, line numbers, status bar) on a Light+ workbench, with a small header naming the theme. In 9:16 it switches to a portrait layout (checked in render 536): a small caps kicker and a 56 px file name at the top left, then a card in the upper half of the frame where lines slide in one by one under a moving highlight bar; at the end one line stays lit, the rest dim, and the card fades. The lower ~40 % of a 9:16 frame stays empty. The eye goes to the highlighted line.
+- **For:** code, prove. **Fights:** Long lines (in 9:16 they wrap, breaking the code shape), a busy background behind it, a voiceover reading the code aloud word for word.
+- **Fit:** Has its own 9:16 layout. 11 s default. Takes code, filename, lang. Code at ~15 px in the 16:9 editor reads small on a phone; the 9:16 card sets code at 40 px. About 10-14 lines fit. The catalog preview is blank, so judge it from a render.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_light_plus.mp4
+
+### `animations.code_snippet_monokai(…)`
+
+A VS Code editor window in the Monokai theme that types out your code.
+
+- **Looks:** 16:9: a full editor (title bar, file tab, explorer sidebar, line numbers, status bar) on a Monokai workbench, with a small header naming the theme. In 9:16 it switches to a portrait layout (checked in render 536): a small caps kicker and a 56 px file name at the top left, then a card in the upper half of the frame where lines slide in one by one under a moving highlight bar; at the end one line stays lit, the rest dim, and the card fades. The lower ~40 % of a 9:16 frame stays empty. The eye goes to the highlighted line.
+- **For:** code, prove. **Fights:** Long lines (in 9:16 they wrap, breaking the code shape), a busy background behind it, a voiceover reading the code aloud word for word.
+- **Fit:** Has its own 9:16 layout. 11 s default. Takes code, filename, lang. Code at ~15 px in the 16:9 editor reads small on a phone; the 9:16 card sets code at 40 px. About 10-14 lines fit. The catalog preview is blank, so judge it from a render.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_monokai.mp4
+
+### `animations.code_snippet_solarized_light(…)`
+
+A VS Code editor window in the Solarized Light theme that types out your code.
+
+- **Looks:** 16:9: a full editor (title bar, file tab, explorer sidebar, line numbers, status bar) on a Solarized Light workbench, with a small header naming the theme. In 9:16 it switches to a portrait layout (checked in render 536): a small caps kicker and a 56 px file name at the top left, then a card in the upper half of the frame where lines slide in one by one under a moving highlight bar; at the end one line stays lit, the rest dim, and the card fades. The lower ~40 % of a 9:16 frame stays empty. The eye goes to the highlighted line.
+- **For:** code, prove. **Fights:** Long lines (in 9:16 they wrap, breaking the code shape), a busy background behind it, a voiceover reading the code aloud word for word.
+- **Fit:** Has its own 9:16 layout. 11 s default. Takes code, filename, lang. Code at ~15 px in the 16:9 editor reads small on a phone; the 9:16 card sets code at 40 px. About 10-14 lines fit. The catalog preview is blank, so judge it from a render.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_snippet_solarized_light.mp4
+
+### `animations.code_snippet_visual_studio_dark(…)`
+
+A VS Code editor window in the Visual Studio Dark theme that types out your code.
+
+- **Looks:** 16:9: a full editor (title bar, file tab, explorer sidebar, line numbers, status bar) on a Visual Studio Dark workbench, with a small header naming the theme. In 9:16 it switches to a portrait layout (checked in render 536): a small caps kicker and a 56 px file name at the top left, then a card in the upper half of the frame where lines slide in one by one under a moving highlight bar; at the end one line stays lit, the rest dim, and the card fades. The lower ~40 % of a 9:16 frame stays empty. The eye goes to the highlighted line.
+- **For:** code, prove. **Fights:** Long lines (in 9:16 they wrap, breaking the code shape), a busy background behind it, a voiceover reading the code aloud word for word.
+- **Fit:** Has its own 9:16 layout. 11 s default. Takes code, filename, lang. Code at ~15 px in the 16:9 editor reads small on a phone; the 9:16 card sets code at 40 px. About 10-14 lines fit. The catalog preview is blank, so judge it from a render.
+
+### `animations.code_snippet_visual_studio_light(…)`
+
+A VS Code editor window in the Visual Studio Light theme that types out your code.
+
+- **Looks:** 16:9: a full editor (title bar, file tab, explorer sidebar, line numbers, status bar) on a Visual Studio Light workbench, with a small header naming the theme. In 9:16 it switches to a portrait layout (checked in render 536): a small caps kicker and a 56 px file name at the top left, then a card in the upper half of the frame where lines slide in one by one under a moving highlight bar; at the end one line stays lit, the rest dim, and the card fades. The lower ~40 % of a 9:16 frame stays empty. The eye goes to the highlighted line.
+- **For:** code, prove. **Fights:** Long lines (in 9:16 they wrap, breaking the code shape), a busy background behind it, a voiceover reading the code aloud word for word.
+- **Fit:** Has its own 9:16 layout. 11 s default. Takes code, filename, lang. Code at ~15 px in the 16:9 editor reads small on a phone; the 9:16 card sets code at 40 px. About 10-14 lines fit. The catalog preview is blank, so judge it from a render.
+
+### `animations.code_typing(…)`
+
+A minimal editor window that types your code with a caret.
+
+- **Looks:** Dark editor window (file name in the title bar, line numbers) on a navy glow; characters appear one by one with a blinking caret. Quiet and readable.
+- **For:** code. **Fights:** Long code (typing takes the whole beat), fast cuts.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes code, lang, theme, filename. Code sits ~30 px in a 1920 frame: in 9:16 it shrinks to ~17 px, too small on a phone. Use it at 16:9, or build a code card from `text` lines at 9:16.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__code_typing.mp4
+
+### `animations.custom_html(…)`
+
+Your own HTML/CSS/GSAP animation, rendered frame by frame.
+
+- **Looks:** Whatever you author. It draws on a transparent stage over the footage below.
+- **For:** texture, emphasize, demo. **Fights:** Nothing by itself; the risk is effort and untested layout.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes src, html. You write it, so you must render and look at it. See the author contract in animations-catalog.md.
+
+### `animations.instagram_follow(…)`
+
+An Instagram-style profile pill with a Follow button that flips to Following.
+
+- **Looks:** A dark rounded pill with avatar, display name, handle and follower count; a pink Follow button that is pressed and turns grey "Following". Native vertical design, small in the frame.
+- **For:** cta, brand. **Fights:** A busy picture right behind the pill; landscape frames (it is designed for 9:16).
+- **Fit:** Vertical design (1080x1920): fills 9:16; in 16:9 it shrinks with side bands. 5 s default. Takes displayName, handle, followers, avatarUrl, url. Image asset via avatarUrl. One name and handle.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__instagram_follow.mp4
+
+### `animations.ios26_liquid_glass(…)`
+
+An iOS 26 liquid-glass device scene.
+
+- **Looks:** A blurred blue-violet wallpaper with frosted glass panels; slow, glossy and abstract.
+- **For:** texture, establish. **Fights:** Anything that needs your own content: it takes no params.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 15 s default. Takes no params. Demo block: most of what it shows is fixed artwork; only the listed params change. No params at all. WebGL: heavy render.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__ios26_liquid_glass.mp4?v=f9f046f0
+
+### `animations.liquid_glass_context_menu(…)`
+
+A liquid-glass context menu over an aurora shader background.
+
+- **Looks:** A moving aurora gradient behind a frosted glass menu panel listing a file name and metadata.
+- **For:** demo, texture. **Fights:** Content that is not a file or menu.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 8 s default. Takes fileName, fileMeta. Demo block: most of what it shows is fixed artwork; only the listed params change. fileName and fileMeta are yours. No catalog preview.
+
+### `animations.liquid_glass_media_controls(…)`
+
+A small liquid-glass media player panel.
+
+- **Looks:** A compact frosted panel with track title, artist and play controls, small in the frame on dark.
+- **For:** demo. **Fights:** Large phones-first framing: the panel is small.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 8 s default. Takes trackTitle, artist. Demo block: most of what it shows is fixed artwork; only the listed params change. trackTitle and artist are yours.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__liquid_glass_media_controls.mp4?v=24d2c880
+
+### `animations.liquid_glass_notification(…)`
+
+Liquid-glass notifications sliding in over a colourful wave wallpaper.
+
+- **Looks:** A loud orange/blue/purple wave wallpaper fills the frame; frosted notification cards slide in at the top right.
+- **For:** demo, announce. **Fights:** Brand palettes that clash with the fixed rainbow wallpaper.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 8 s default. Takes title, body, messageText. Demo block: most of what it shows is fixed artwork; only the listed params change. title, body and messageText are yours.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__liquid_glass_notification.mp4
+
+### `animations.liquid_glass_widgets(…)`
+
+A row of liquid-glass widgets with a title card.
+
+- **Looks:** Dark frame with a row of small glossy widget tiles and a frosted card; restrained motion.
+- **For:** demo. **Fights:** Anything that needs to be read from a phone: the tiles are small.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 8 s default. Takes showcaseTitle, showcaseDescription. Demo block: most of what it shows is fixed artwork; only the listed params change. showcaseTitle and showcaseDescription are yours.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__liquid_glass_widgets.mp4
+
+### `animations.logo_outro(…)`
+
+A logo sting: the logo appears with a glow and a tagline under it.
+
+- **Looks:** Dark frame; a small accent dot grows into the logo badge with a soft glow behind it, then the tagline (and URL) fades in below, centred.
+- **For:** brand, cta. **Fights:** Being anywhere but the end; a missing logo (without logoUrl or brand it shows a Figma-style demo mark).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 6 s default. Takes tagline, url, logoUrl, brand, accent. Image asset via logoUrl. Pass logoUrl or brand: "scenerok". Tagline: one short line.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__logo_outro.mp4
+
+### `animations.lower_third(…)`
+
+A plain lower third: a bold name over a smaller role, with an accent rule.
+
+- **Looks:** A thin blue rule draws out, then a bold white name and a grey role appear under it, left-aligned. No box behind the text.
+- **For:** name. **Fights:** Bright busy footage behind it (there is no plate for contrast).
+- **Fit:** Has its own 9:16 layout. 5 s default. Takes title, subtitle. Name and role, one line each.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__lower_third.mp4
+
+### `animations.lower_third_bild(…)`
+
+A tabloid-style lower third: a white name box with a red tag.
+
+- **Looks:** A white box with a heavy black name and a red role tag under it. Loud, news-like.
+- **For:** name, announce. **Fights:** Calm, premium edits.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and a layout profile repositions it; type reads small. 8 s default. Takes title, subtitle, accent, bg. Short name, one-word role.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__lower_third_bild.mp4
+
+### `animations.lt_accent_underline(…)`
+
+A broadcast lower third: a name and a role in a caps name with a coloured underline.
+
+- **Looks:** A caps name with a coloured underline enters from the left edge of the lower third, the name (bold) first and the role (smaller) after; it holds still once settled. The frame above stays free for the picture.
+- **For:** name. **Fights:** A picture with its own text in the lower third, a second lower third, long titles (two short lines is the design).
+- **Fit:** Has its own 9:16 layout. 5 s default. Takes title, subtitle, accent, bg. Name up to ~24 characters, role up to ~32.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__lt_accent_underline.mp4
+
+### `animations.lt_bold_block(…)`
+
+A broadcast lower third: a name and a role in a heavy block with a yellow role bar.
+
+- **Looks:** A heavy block with a yellow role bar enters from the left edge of the lower third, the name (bold) first and the role (smaller) after; it holds still once settled. The frame above stays free for the picture. Strong and broadcast-like.
+- **For:** name. **Fights:** A picture with its own text in the lower third, a second lower third, long titles (two short lines is the design).
+- **Fit:** Has its own 9:16 layout. 5 s default. Takes title, subtitle, accent, bg. Name up to ~24 characters, role up to ~32.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__lt_bold_block.mp4
+
+### `animations.lt_clean_bar(…)`
+
+A broadcast lower third: a name and a role in a white card with an accent edge.
+
+- **Looks:** A white card with an accent edge enters from the left edge of the lower third, the name (bold) first and the role (smaller) after; it holds still once settled. The frame above stays free for the picture.
+- **For:** name. **Fights:** A picture with its own text in the lower third, a second lower third, long titles (two short lines is the design).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and a layout profile repositions it; type reads small. 5 s default. Takes title, subtitle, accent, bg. Name up to ~24 characters, role up to ~32.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__lt_clean_bar.mp4
+
+### `animations.lt_color_block(…)`
+
+A broadcast lower third: a name and a role in a solid accent-coloured block.
+
+- **Looks:** A solid accent-coloured block enters from the left edge of the lower third, the name (bold) first and the role (smaller) after; it holds still once settled. The frame above stays free for the picture.
+- **For:** name. **Fights:** A picture with its own text in the lower third, a second lower third, long titles (two short lines is the design).
+- **Fit:** Has its own 9:16 layout. 5 s default. Takes title, subtitle, accent, bg. Name up to ~24 characters, role up to ~32.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__lt_color_block.mp4
+
+### `animations.lt_dark_card(…)`
+
+A broadcast lower third: a name and a role in a dark card.
+
+- **Looks:** A dark card enters from the left edge of the lower third, the name (bold) first and the role (smaller) after; it holds still once settled. The frame above stays free for the picture.
+- **For:** name. **Fights:** A picture with its own text in the lower third, a second lower third, long titles (two short lines is the design).
+- **Fit:** Has its own 9:16 layout. 5 s default. Takes title, subtitle, accent, bg. Name up to ~24 characters, role up to ~32.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__lt_dark_card.mp4
+
+### `animations.lt_kicker_name(…)`
+
+A lower third with a small coloured kicker tag above a caps name.
+
+- **Looks:** A small accent tag (the kicker, e.g. a role or label) appears first, then the name in caps below with an underline. Lower third of the frame; holds still once in.
+- **For:** name. **Fights:** Pictures with text low in frame; a second lower third.
+- **Fit:** Has its own 9:16 layout. 5 s default. Takes kicker, title, accent. Kicker: one or two words. Name: up to ~24 characters.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__lt_kicker_name.mp4
+
+### `animations.lt_mask_reveal(…)`
+
+A broadcast lower third: a name and a role in a name revealed by a wipe mask.
+
+- **Looks:** A name revealed by a wipe mask enters from the left edge of the lower third, the name (bold) first and the role (smaller) after; it holds still once settled. The frame above stays free for the picture. The text is wiped on rather than faded.
+- **For:** name. **Fights:** A picture with its own text in the lower third, a second lower third, long titles (two short lines is the design).
+- **Fit:** Has its own 9:16 layout. 5 s default. Takes title, subtitle, accent, bg. Name up to ~24 characters, role up to ~32.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__lt_mask_reveal.mp4
+
+### `animations.lt_side_rule(…)`
+
+A broadcast lower third: a name and a role in a thin vertical rule beside the name.
+
+- **Looks:** A thin vertical rule beside the name enters from the left edge of the lower third, the name (bold) first and the role (smaller) after; it holds still once settled. The frame above stays free for the picture.
+- **For:** name. **Fights:** A picture with its own text in the lower third, a second lower third, long titles (two short lines is the design).
+- **Fit:** Has its own 9:16 layout. 5 s default. Takes title, subtitle, accent, bg. Name up to ~24 characters, role up to ~32.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__lt_side_rule.mp4
+
+### `animations.lt_soft_pill(…)`
+
+A broadcast lower third: a name and a role in a soft white pill.
+
+- **Looks:** A soft white pill enters from the left edge of the lower third, the name (bold) first and the role (smaller) after; it holds still once settled. The frame above stays free for the picture.
+- **For:** name. **Fights:** A picture with its own text in the lower third, a second lower third, long titles (two short lines is the design).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and a layout profile repositions it; type reads small. 5 s default. Takes title, subtitle, accent, bg. Name up to ~24 characters, role up to ~32.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__lt_soft_pill.mp4
+
+### `animations.lt_stack_bars(…)`
+
+A broadcast lower third: a name and a role in a dark bar with a yellow role bar stacked under it.
+
+- **Looks:** A dark bar with a yellow role bar stacked under it enters from the left edge of the lower third, the name (bold) first and the role (smaller) after; it holds still once settled. The frame above stays free for the picture.
+- **For:** name. **Fights:** A picture with its own text in the lower third, a second lower third, long titles (two short lines is the design).
+- **Fit:** Has its own 9:16 layout. 5 s default. Takes title, subtitle, accent, bg. Name up to ~24 characters, role up to ~32.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__lt_stack_bars.mp4?v=be9b5b4f
+
+### `animations.macos_notification(…)`
+
+A macOS notification banner sliding in at the top right.
+
+- **Looks:** A small grey translucent banner with app icon, app name, title and body slides in at the top right and holds. Tiny in a phone frame.
+- **For:** prove, announce. **Fights:** Text-heavy frames; 9:16 (it is a small corner element).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes appName, timeLabel, title, body. App name, title and one body line.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__macos_notification.mp4
+
+### `animations.macos_tahoe_liquid_glass(…)`
+
+A macOS Tahoe desktop with liquid-glass windows over a wallpaper.
+
+- **Looks:** A soft blue-violet desktop wallpaper with a menu bar, glass windows, a toast and a weather widget. Glossy and slow.
+- **For:** demo, establish. **Fights:** Fast pacing; anything that is not a desktop.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 15 s default. Takes wallpaperUrl, windowTitle, toastBody, weatherLocation. Image asset via wallpaperUrl. Demo block: most of what it shows is fixed artwork; only the listed params change. wallpaperUrl, windowTitle, toastBody, weatherLocation are yours. WebGL: heavy render.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__macos_tahoe_liquid_glass.mp4?v=7bc0b4f8
+
+### `animations.news_ticker(…)`
+
+A TV news strap: a red label, a headline and a scrolling ticker.
+
+- **Looks:** A dark strap across the lower part of the frame with a red "breaking" label at the left, a bold headline with an accent-coloured phrase, and a ticker crawling along a thinner bar under it.
+- **For:** announce. **Fights:** Premium or calm tone; a second strap or lower third.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and a layout profile repositions it; type reads small. 7 s default. Takes desk, time, label, headline, headlineAccent, ticker. Headline under ~40 characters; ticker items separated by newlines.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__news_ticker.mp4
+
+### `animations.reddit_post(…)`
+
+A Reddit post card with subreddit, title, body and votes.
+
+- **Looks:** A small dark card: subreddit and author at the top, a bold title, a few lines of body, vote and comment counts at the bottom.
+- **For:** prove, quote. **Fights:** Small phones (the card is small), long post bodies.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes subreddit, author, title, body, votes. Title plus two or three body lines.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__reddit_post.mp4
+
+### `animations.spotify_card(…)`
+
+A Spotify now-playing card with album art and track name.
+
+- **Looks:** A tall dark card filling much of a 9:16 frame: a big green album square with a music note, the track title and artist under it. Native vertical design.
+- **For:** sound, prove. **Fights:** 16:9 frames (it is a vertical card).
+- **Fit:** Vertical design (1080x1920): fills 9:16; in 16:9 it shrinks with side bands. 5 s default. Takes track, artist. Track and artist.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__spotify_card.mp4
+
+### `animations.text_counter_stat(…)`
+
+A big number that counts up, with a small label and an underline.
+
+- **Looks:** Transparent overlay. A very large bold number in the centre ticks up to its value with an accent-coloured suffix, a small spaced-out caps label under it and a short accent underline. The eye locks on the number.
+- **For:** count, emphasize. **Fights:** A second number on screen; numbers that are not impressive at a glance.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes value, label, prefix, suffix, color, accent. One number and a 1-3 word label. suffix defaults to "+", so pass suffix: "" unless the number is a floor. ~146 px number in 9:16.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__text_counter_stat.mp4?v=648434e3
+
+### `animations.text_glitch_title(…)`
+
+A title that arrives with an RGB-split glitch and settles clean.
+
+- **Looks:** Transparent overlay; a heavy caps title jitters with red/blue channel offsets, then snaps to clean white.
+- **For:** announce, emphasize. **Fights:** Calm or premium tone, motion-sensitive viewers.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes text, color. Two or three words.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__text_glitch_title.mp4?v=b2bec3e7
+
+### `animations.text_gradient_sweep(…)`
+
+A headline filled with a moving gradient.
+
+- **Looks:** Transparent overlay; a bold headline whose letters fill with a pink-to-violet gradient that sweeps across them.
+- **For:** announce. **Fights:** Brand palettes that do not include the gradient colours (set from/to), photos behind it.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes text, from, to. A short headline, one line.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__text_gradient_sweep.mp4?v=fa7aee38
+
+### `animations.text_kinetic_words(…)`
+
+Kinetic type: one big word at a time, on the beat.
+
+- **Looks:** Transparent overlay; single words flash up large in the centre one after another, alternating white and an accent colour.
+- **For:** emphasize, announce. **Fights:** Sentences that need reading as a whole, slow music.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes text, color, accent. Three to six short words.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__text_kinetic_words.mp4?v=15009872
+
+### `animations.text_line_stack(…)`
+
+Two or three lines of a title revealed through masks, one after another.
+
+- **Looks:** Transparent overlay; a short accent rule, then each line rises out of a mask, the second in the accent colour. Clean editorial look.
+- **For:** announce, list. **Fights:** Long lines (two to four words per line is the design).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes line1, line2, line3, color, accent. line1, line2, optional line3.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__text_line_stack.mp4?v=d11dc02f
+
+### `animations.text_neon_flicker(…)`
+
+A neon-sign title that flickers on.
+
+- **Looks:** Transparent overlay; grey unlit letters flicker, then glow in a saturated neon colour with a soft halo.
+- **For:** establish, emphasize. **Fights:** Bright backgrounds (the glow needs dark), motion-sensitive viewers.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes text, color. One or two words.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__text_neon_flicker.mp4?v=028f1626
+
+### `animations.text_scramble_decode(…)`
+
+A title that decodes from random characters.
+
+- **Looks:** Transparent overlay; a line of monospaced random symbols in an accent green resolves left to right into the real words.
+- **For:** announce, code. **Fights:** Warm or human tone; long titles.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes text, color, accent. One short line.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__text_scramble_decode.mp4?v=5578cf99
+
+### `animations.text_typewriter_quote(…)`
+
+A quote typed out in italics, with the author under it.
+
+- **Looks:** Transparent overlay; a serif italic quote types out with a caret, centred, then the attribution fades in small below.
+- **For:** quote. **Fights:** Long quotes (typing time grows), busy pictures behind serif type.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes text, author, color, accent. One or two sentences.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__text_typewriter_quote.mp4?v=c4c64c37
+
+### `animations.text_word_cascade(…)`
+
+A headline whose words drop in one by one, the last in an accent colour.
+
+- **Looks:** Transparent overlay; bold words fall into place in sequence, centred, with the last word in the accent colour.
+- **For:** announce. **Fights:** Headlines whose key word is not last.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes text, color, accent. Three to eight words.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__text_word_cascade.mp4?v=2eca3c74
+
+### `animations.tiktok_follow(…)`
+
+A TikTok-style profile pill with a Follow button that flips to Following.
+
+- **Looks:** A dark rounded pill with avatar, display name, handle and followers; a red Follow button is pressed and turns grey "Following". Native vertical design.
+- **For:** cta, brand. **Fights:** Landscape frames; a busy picture right behind it.
+- **Fit:** Vertical design (1080x1920): fills 9:16; in 16:9 it shrinks with side bands. 5 s default. Takes displayName, handle, followers, avatarUrl, url. Image asset via avatarUrl. One name and handle.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__tiktok_follow.mp4
+
+### `animations.ui_3d_reveal(…)`
+
+A design-tool canvas (Figma-like) that reveals a UI in 3D.
+
+- **Looks:** Dark canvas with a faint logo, then a desktop design-tool window slides up in perspective showing a UI mock.
+- **For:** demo, announce. **Fights:** Short beats (13 s default), phone frames (the window is small).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 13 s default. Takes heroTitle, outroUrl. Demo block: most of what it shows is fixed artwork; only the listed params change. heroTitle and outroUrl are yours.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__ui_3d_reveal.mp4
+
+### `animations.vfx_iphone_device(…)`
+
+A 3D iPhone that shows your screenshot, lit like a product render.
+
+- **Looks:** A dark studio frame with a glossy 3D phone on a turntable that breathes and turns slightly; your image is on its screen.
+- **For:** demo, prove. **Fights:** Landscape screenshots; quick cuts (15 s default).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 15 s default. Takes imageUrl. Image asset via imageUrl. Needs imageUrl (portrait screenshot). WebGL: heavy render. No catalog preview.
+
+### `animations.vpn_youtube_spot(…)`
+
+An app-ad layout: a bold two-line headline beside a phone mock-up.
+
+- **Looks:** Bright white-blue frame; a heavy black-and-blue two-line headline at the left, a subtext line, and a phone on the right whose screen shows an app card.
+- **For:** announce, demo. **Fights:** Dark palettes; apps that are not mobile.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 7 s default. Takes headlineLine1, headlineLine2, subtext, appTitle, appSubtitle. Demo block: most of what it shows is fixed artwork; only the listed params change. headlineLine1, headlineLine2, subtext, appTitle and appSubtitle are yours.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__vpn_youtube_spot.mp4
+
+### `animations.x_post(…)`
+
+An X (Twitter) post card.
+
+- **Looks:** A small dark card: avatar, display name, handle, the post body, a hashtag and engagement counts.
+- **For:** prove, quote. **Fights:** Small phones (the card is small), long posts.
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and sits in a centred 16:9 band. 5 s default. Takes displayName, handle, body, hashtag, timestamp. Body under ~200 characters.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__x_post.mp4
+
+### `animations.yt_lower_third(…)`
+
+A YouTube channel lower third with a Subscribe button.
+
+- **Looks:** A small white pill in the lower corner with avatar, channel name, subscriber count and a dark Subscribe button.
+- **For:** cta, name. **Fights:** Busy lower-corner content; 9:16 (it reads tiny).
+- **Fit:** 16:9 design: in 9:16 it scales to 56 % and a layout profile repositions it; type reads small. 5 s default. Takes channel, subscribers, avatarUrl. Image asset via avatarUrl. Channel name and count.
+- **Preview:** https://assets-public.scenerok.com/catalog/animations__yt_lower_third.mp4
+
+## Text
+
+Syntax and params: vidscript-guide.md → Text Overlay.
+
+### `text`
+
+A plain text layer: your font, size, colour and position.
+
+- **Looks:** Exactly the type you set, still unless you add `animate:`. The most legible thing in the toolbox; with a strong font and size it carries a beat on its own.
+- **For:** announce, list, count, cta, name, quote. **Fights:** A busy picture directly behind it (add a plate, shadow or stroke), sizes under 2.2 % of the frame height.
+- **Fit:** Validate measures it (wrap, shrink, collisions) but its widths are estimates: check a frame. font: is one Google Fonts family at weight 400.
+
+### `text+area`
+
+Text placed in a named grid area that wraps and shrinks to fit.
+
+- **Looks:** The same text, centred in its cell (title, stage, lower-third, caption, or your own grid). Predictable and safe, a little generic.
+- **For:** announce, caption, list. **Fights:** Designed layouts where position is part of the look.
+
+### `text+plate`
+
+Text over a `solid(...)` with a radius: a card, pill or button.
+
+- **Looks:** A coloured shape with type on it; reads as a UI element (a button, a badge, a label). The shape carries contrast, so it works over any picture.
+- **For:** cta, name, count. **Fights:** Too many plates (the frame turns into a dashboard).
+- **Fit:** Text background:, padding: and radius: are ignored by the renderer; a solid under the text is the way.
+
+### `text+stagger`
+
+Text revealed word by word or character by character (`stagger:`).
+
+- **Looks:** The line builds piece by piece over its animation.
+- **For:** announce, emphasize. **Fights:** Combined with an exit in the same list (the reveal rendered half-done in testing), long lines.
+
+### `captions`
+
+Burned-in captions from an SRT file, one text layer per cue.
+
+- **Looks:** Timed lines of text in one style, swapping with the speech.
+- **For:** caption. **Fights:** Other text in the caption area; local SRT paths on hosted renders (needs an HTTPS URL).
+
+## Motion primitives
+
+Syntax and params: text-styles.md.
+
+### `motion.fadeIn(…)`
+
+Opacity from 0 to 1 at the start of the block.
+
+- **Looks:** The element simply appears out of nothing; no movement. The quietest entrance there is.
+- **For:** establish, list. **Fights:** Moments that need impact.
+- **Fit:** Default 0.5 s. A still element is often right: motion should mean something (arrival, emphasis), not decorate.
+
+### `motion.fadeOut(…)`
+
+Opacity from 1 to 0 at the end of the block.
+
+- **Looks:** The element dims away over the last part of its window; the frame empties softly.
+- **For:** transition. **Fights:** A hard cut that should stay hard.
+- **Fit:** Default 0.5 s, aligned to the end of the block.
+
+### `motion.slideX(…)`
+
+Moves the element horizontally from one offset to another.
+
+- **Looks:** The element travels sideways into place. With a large offset it enters from off-frame.
+- **For:** list, transition. **Fights:** A second sideways move at the same time.
+- **Fit:** slideX(from, to, duration); default 0.6 s.
+
+### `motion.slideY(…)`
+
+Moves the element vertically from one offset to another.
+
+- **Looks:** The element travels up or down into place, without fading.
+- **For:** list. **Fights:** Text that should be read during the move.
+- **Fit:** slideY(from, to, duration); default 0.6 s.
+
+### `motion.popIn(…)`
+
+Scales from 55 % past 100 % and settles, while fading in.
+
+- **Looks:** The element bursts in slightly oversized (106 %) and settles; a small, confident bounce. The eye snaps to it.
+- **For:** emphasize, count, cta. **Fights:** Several pops at once (they cancel each other out), calm or serious tone.
+- **Fit:** Default 0.5 s.
+
+### `motion.riseIn(…)`
+
+Rises 80 px into place while fading in.
+
+- **Looks:** The element drifts up a short distance as it appears; editorial, gentle, reads as "arriving".
+- **For:** announce, list, establish. **Fights:** Things that should feel heavy or sudden.
+- **Fit:** riseIn(duration, distance).
+
+### `motion.swingIn(…)`
+
+Rotates in from -14° and rises while fading in.
+
+- **Looks:** The element swings into place like a hanging sign. Playful.
+- **For:** emphasize. **Fights:** Serious or premium tone; long text.
+
+### `motion.glitchIn(…)`
+
+Fades in from 20 % with a positional jitter.
+
+- **Looks:** The element shakes rapidly by a few pixels as it comes up to full opacity; nervy, digital.
+- **For:** texture, emphasize. **Fights:** Calm tone, motion-sensitive viewers.
+
+### `motion.float(…)`
+
+A gentle continuous vertical drift.
+
+- **Looks:** The element bobs up and down by a few pixels for as long as it is on screen; it feels alive without drawing attention.
+- **For:** texture, brand. **Fights:** Text that must be read precisely; several floating elements out of phase.
+- **Fit:** float(period, amplitude). Small amplitudes (8-14 px) read as life; large ones read as wobble.
+
+### `motion.typewriter(…)`
+
+Reveals text character by character.
+
+- **Looks:** The text types itself out left to right; the eye follows the leading edge.
+- **For:** code, quote. **Fights:** Long text (it takes the whole beat), multi-line blocks in one text layer.
+- **Fit:** typewriter(duration). For code, one text layer per line types more reliably.
+
+## Transitions
+
+Syntax and params: transitions-catalog.md.
+
+### `tr.dissolve()`
+
+A cross-fade.
+
+- **Looks:** Both shots are visible at once at mid-point, each half transparent. Nothing moves; the eye barely notices it.
+- **For:** transition, establish. **Fights:** Fast, energetic cuts (it softens them).
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__dissolve.mp4
+
+### `tr.push()`
+
+The new shot pushes the old one out of frame.
+
+- **Looks:** Both shots slide together in one direction like a carousel; the edge between them is hard. direction: sets the side.
+- **For:** transition. **Fights:** Shots with strong opposite motion inside them.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__push.mp4
+
+### `tr.cover()`
+
+The new shot slides over the old one, like a door.
+
+- **Looks:** The incoming shot moves in over a still outgoing shot, which is revealed behind as a doorway opening.
+- **For:** transition. **Fights:** Busy outgoing shots (they stay visible under the move).
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__cover.mp4
+
+### `tr.radial()`
+
+The new shot opens from the centre in a circle.
+
+- **Looks:** A growing circle in the middle shows the new shot; the old shot remains outside the ring until it fills the frame.
+- **For:** transition. **Fights:** Shots whose subject is off-centre.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__radial.mp4
+
+### `tr.grid()`
+
+The frame flips in a grid of tiles.
+
+- **Looks:** The picture breaks into a grid of square tiles that flip over in a wave to show the new shot. Busy and techy.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__grid.mp4
+
+### `tr.scale()`
+
+A cross-zoom: the old shot zooms in and blurs into the new one.
+
+- **Looks:** The old shot rushes toward the viewer with radial blur while the new one zooms out of it. Fast and energetic.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__scale.mp4
+
+### `tr.cube()`
+
+The two shots as faces of a rotating cube.
+
+- **Looks:** The frame turns like a 3D cube; the old shot recedes on one face as the new shot comes round on the next.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__cube.mp4
+
+### `tr.blur()`
+
+A blur-through: the old shot blurs out, the new one blurs in.
+
+- **Looks:** At mid-point both shots are soft and mixed; focus returns on the new shot. Gentle.
+- **For:** transition, establish. **Fights:** Text-heavy shots (the text smears).
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__blur.mp4
+
+### `tr.distortion()`
+
+A directional warp between the shots.
+
+- **Looks:** The old shot stretches and smears in one direction and the new one snaps in behind it.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__distortion.mp4
+
+### `tr.destruction()`
+
+A burn: the new shot burns through the old one by brightness.
+
+- **Looks:** Bright areas of the picture go first, with a hot edge eating through the old shot to reveal the new.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__destruction.mp4
+
+### `tr.light()`
+
+A luminance melt.
+
+- **Looks:** The old shot melts downward by brightness, dripping into the new one.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__light.mp4
+
+### `tr.mechanical()`
+
+Window blinds.
+
+- **Looks:** Horizontal slats open across the frame to show the new shot, like blinds turning.
+- **For:** transition. **Fights:** Soft, organic material.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__mechanical.mp4
+
+### `tr.wipe()`
+
+A linear wipe.
+
+- **Looks:** A straight edge travels across the frame, old shot on one side, new on the other. direction: sets the side.
+- **For:** transition. **Fights:** Shots where the edge would cut through a face.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__wipe.mp4
+
+### `tr.cinematic_zoom()`
+
+A cross-zoom tuned for a filmic push.
+
+- **Looks:** Like `scale`: the old shot pushes in with radial blur and resolves into the new one.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__cinematic_zoom.mp4
+
+### `tr.whip_pan()`
+
+A whip pan: a fast slide with motion blur.
+
+- **Looks:** Both shots streak sideways with heavy horizontal blur; the cut happens inside the blur. Feels like a fast camera move. direction: sets the side.
+- **For:** transition. **Fights:** Static, calm shots; text on screen during the move.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__whip_pan.mp4
+
+### `tr.light_leak()`
+
+A bright light leak that washes into the new shot.
+
+- **Looks:** The frame blooms with warm light, then the new shot fades up out of it. Filmic, nostalgic.
+- **For:** transition. **Fights:** Flashing or rapid luminance change: avoid repeating it for viewers sensitive to flicker.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end. Flashing or rapid luminance change: avoid repeating it for viewers sensitive to flicker.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__light_leak.mp4
+
+### `tr.flash()`
+
+A flash through white.
+
+- **Looks:** The old shot burns up to white, then the new shot comes down out of the white. Punchy.
+- **For:** transition. **Fights:** Flashing or rapid luminance change: avoid repeating it for viewers sensitive to flicker.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end. Flashing or rapid luminance change: avoid repeating it for viewers sensitive to flicker.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__flash.mp4
+
+### `tr.warp_morph()`
+
+A warping morph between the shots.
+
+- **Looks:** Both shots ripple and bend into each other as they dissolve, like a liquid morph.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__warp_morph.mp4
+
+### `tr.domain_warp()`
+
+A noise-driven warp between the shots.
+
+- **Looks:** The picture swirls in organic, cloudy distortion (fractal noise) as one shot turns into the other.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__domain_warp.mp4
+
+### `tr.chromatic_split()`
+
+An RGB split that tears one shot into the next.
+
+- **Looks:** Red, green and blue channels pull apart radially, then the new shot pulls together. Glitchy and digital.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end. Flashing or rapid luminance change: avoid repeating it for viewers sensitive to flicker.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__chromatic_split.mp4
+
+### `tr.lens()`
+
+A gravitational-lens warp.
+
+- **Looks:** The centre of the frame bulges like a lens and the new shot appears through the bulge.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__lens.mp4
+
+### `tr.glitch()`
+
+A block glitch.
+
+- **Looks:** The frame breaks into shifted rectangular blocks and colour errors, then resolves on the new shot.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end. Flashing or rapid luminance change: avoid repeating it for viewers sensitive to flicker.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__glitch.mp4
+
+### `tr.swirl()`
+
+A vortex swirl.
+
+- **Looks:** The old shot spins into a whirlpool at the centre and unwinds into the new one.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__swirl.mp4
+
+### `tr.thermal()`
+
+A heat-haze dissolve.
+
+- **Looks:** The picture wavers like heat over tarmac while the shots dissolve.
+- **For:** transition, texture. **Fights:** Sharp graphic content (it wobbles).
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__thermal.mp4
+
+### `tr.ripple()`
+
+A ripple dissolve.
+
+- **Looks:** Concentric water ripples spread from the centre as the shots cross over.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__ripple.mp4
+
+### `tr.iris()`
+
+An iris: a circle opens on the new shot.
+
+- **Looks:** A hard-edged circle grows from the centre to reveal the new shot, like a camera iris. Old-film feel.
+- **For:** transition. **Fights:** Off-centre subjects.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__iris.mp4
+
+### `tr.burn()`
+
+A ridged burn through the old shot.
+
+- **Looks:** Like `destruction`: a burning edge eats through by brightness to show the new shot.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__burn.mp4
+
+### `tr.shatter()`
+
+The old shot shatters like glass.
+
+- **Looks:** The frame cracks into Voronoi shards that fall away to reveal the new shot. Dramatic.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__shatter.mp4
+
+### `tr.liquid()`
+
+A liquid morph.
+
+- **Looks:** The old shot flows like liquid into the new one.
+- **For:** transition. **Fights:** Calm or premium edits; cuts between similar shots, where a hard cut reads better.
+- **Fit:** 0.6 s default; blends the clip showing at the window's start into the one showing at its end.
+- **Preview:** https://assets-public.scenerok.com/catalog/transitions__liquid.mp4
+
+## Filters and grades
+
+Syntax and params: editing-actions.md → Color and finishing, shaders-filters.md.
+
+### `filter "cdl"`
+
+An ASC CDL colour grade: slope, offset, power per channel, plus saturation.
+
+- **Looks:** A whole-frame colour shift you feel more than see: warmer or cooler, richer or flatter. Nothing moves.
+- **For:** grade. **Fights:** Footage that is already graded; brand colours that must stay exact.
+- **Fit:** No file needed, so it works on hosted renders. Per-pixel: can target one clip.
+
+### `filter "lut"`
+
+A 3D .cube look-up table applied to the frame or a clip.
+
+- **Looks:** A complete film-style look in one step: tone curve and colour cast together.
+- **For:** grade. **Fights:** Already graded footage; a .cube made for log footage on normal footage (crushes it).
+- **Fit:** Hosted compiles read only an HTTPS URL or data: URI, not a local path. 512 KB, 33 points max.
+
+### `filter "vignette"`
+
+Darkens the edges of the frame.
+
+- **Looks:** The corners fall off toward black and the centre stays bright, pulling the eye inward. At 0.3 it is felt, not seen.
+- **For:** grade. **Fights:** Content near the edges (text, UI), white or light frames (it reads as dirty corners).
+- **Fit:** intensity, default 0.5.
+
+### `filter "contrast"`
+
+Scales contrast around mid-grey.
+
+- **Looks:** Darks deeper and lights brighter; the picture gets punchier.
+- **For:** grade. **Fights:** Faces in harsh light, already contrasty footage.
+- **Fit:** amount, default 1.2.
+
+### `filter "saturation"`
+
+Scales colour intensity.
+
+- **Looks:** Colours richer (above 1) or more muted (below 1).
+- **For:** grade. **Fights:** Skin tones above ~1.2; brand colours.
+- **Fit:** amount, default 1.5 (strong).
+
+### `filter "brightness"`
+
+Adds a constant to every channel.
+
+- **Looks:** The whole frame lifts or drops; blacks turn grey when lifted.
+- **For:** grade. **Fights:** Dark designs (lifted blacks look washed out).
+- **Fit:** amount, default 0.1.
+
+### `filter "monochrome"`
+
+Desaturates to black and white.
+
+- **Looks:** The picture goes grey; with intensity below 1 colour bleeds back in.
+- **For:** grade, establish. **Fights:** Colour that carries meaning (a product colour, a brand).
+- **Fit:** intensity 0-1.
+
+### `filter "sepia"`
+
+A warm brown tint.
+
+- **Looks:** Old-photograph browns over the whole frame.
+- **For:** grade, establish. **Fights:** Modern product shots, brand colours.
+- **Fit:** intensity 0-1.
+
+### `filter "blur"`
+
+A Gaussian blur over everything in its window.
+
+- **Looks:** The frame goes soft; at large radii only colour masses remain. Useful behind text as a plate.
+- **For:** texture. **Fights:** Any text or UI inside its window (blurs it too). Samples neighbours, so it cannot target one clip: put it in a function.
+- **Fit:** radius in px, default 5.
+
+### `filter "chromatic"`
+
+Chromatic aberration: RGB channels offset.
+
+- **Looks:** Colour fringes on every edge, stronger toward the edges; a lens-error or glitch feel.
+- **For:** texture. **Fights:** Small text (fringes make it unreadable), premium product shots.
+- **Fit:** offset, default 0.02. Can be animated for a hit on a cut.
+
+### `filter "glitch"`
+
+Digital distortion over the frame.
+
+- **Looks:** Horizontal tearing and block errors flicker over the picture.
+- **For:** texture, emphasize. **Fights:** Calm tone, readable text, motion-sensitive viewers.
+- **Fit:** intensity, default 0.5. Keep it to a short window.
+
+### `filter "premultiply"`
+
+Multiplies colour by alpha for footage with straight alpha.
+
+- **Looks:** Fixes bright fringes around keyed or transparent footage; otherwise invisible.
+- **For:** edit. **Fights:** Nothing; use it only when edges show halos.
+
+### `filter "liquid_glass"`
+
+A frosted liquid-glass refraction effect over the frame.
+
+- **Looks:** A glossy, refracting glass layer bends the picture under it, iOS-style.
+- **For:** texture. **Fights:** Text under it, already busy footage.
+- **Fit:** Whole frame only (cannot target a clip).
+
+### `filter "magnetic"`
+
+A magnetic snap distortion.
+
+- **Looks:** The picture pulls toward a point as if magnetised, then snaps.
+- **For:** texture. **Fights:** Readable content.
+- **Fit:** Whole frame only.
+
+### `filter "portal"`
+
+A sci-fi portal warp.
+
+- **Looks:** A swirling hole opens in the picture, warping it toward the centre.
+- **For:** texture, transition. **Fights:** Serious tone, text.
+- **Fit:** Whole frame only.
+
+### `filter "text_cursor"`
+
+A blinking text-cursor overlay.
+
+- **Looks:** A terminal-style caret blinks over the frame.
+- **For:** code, texture. **Fights:** Frames without any typing context.
+- **Fit:** Whole frame only.
+
+## Editing and compositing
+
+Syntax and params: editing-actions.md.
+
+### `Trim`
+
+Plays a source range of a clip (with Speed, Loop and reverse).
+
+- **Looks:** A cut: the shot starts and ends where you choose. Speed(0) holds a frame; negative speed reverses.
+- **For:** edit. **Fights:** Nothing; it is the basic cut.
+
+### `Crop`
+
+Shows a source rectangle of a clip, filling its display size.
+
+- **Looks:** A tighter framing of the same shot.
+- **For:** edit. **Fights:** Transitions (a cropped clip cannot sit in one); remote stills (rendered as nothing in testing: crop those with ffmpeg first).
+
+### `placement`
+
+Size, position, rotation, radius and corner-pin on a placed clip or image.
+
+- **Looks:** The picture framed as a card (radius), a tilted insert (rotation), or pinned into a screen (corners). Oversizing it past the frame acts as a crop that transitions accept.
+- **For:** edit, demo. **Fights:** Guessed sizes: probe the asset and keep its aspect.
+
+### `push`
+
+A slow scale animation on a picture (Ken Burns): `animate: { type: "scale", ... }`.
+
+- **Looks:** The picture creeps closer (or away) over the shot. Gives a still a sense of time passing; at 1.0 to 1.08 over 4 s it is felt, not seen.
+- **For:** establish, texture. **Fights:** Pictures with text near the edges (it pushes them out), UI screenshots that must be read, every shot at once (sameness).
+
+### `Overlay`
+
+Puts one picture over a clip at a position (picture-in-picture).
+
+- **Looks:** A smaller inset on top of the main shot.
+- **For:** prove, demo, compare. **Fights:** Busy main shots where the inset gets lost.
+
+### `blend`
+
+Blends a layer with what is below it (`blend:` or `Composite`): screen, multiply, overlay, difference and others.
+
+- **Looks:** Light leaks that only brighten (screen), colour washes that tint (multiply), graphic inversions (difference).
+- **For:** texture, grade. **Fights:** A layer with nothing below it (compile error).
+
+### `Mask`
+
+Draws a clip through a matte: a shape, text, or another clip.
+
+- **Looks:** Footage visible only inside a circle, a rounded card, or the letters of a word.
+- **For:** emphasize, brand, texture. **Fights:** Placing the masked clip under Overlay/Composite (not allowed).
+
+### `grid`
+
+Split screens and layouts via grid areas for clips as well as text.
+
+- **Looks:** Two or more shots side by side or stacked, each in its cell.
+- **For:** compare, demo. **Fights:** Transitions out of the layout (run the layout past the cut instead).
+
+### `motion_blur`
+
+Blurs an item along its own animated motion.
+
+- **Looks:** Fast moves streak like real camera footage instead of strobing.
+- **For:** texture. **Fights:** Slow moves (wasted cost), text and solids (not allowed).
+- **Fit:** Each sample is a full extra render of the frame.
+
+### `duck_under`
+
+Lowers a music bed while a named voice track plays.
+
+- **Looks:** Nothing on screen; the voice sits clearly over the music.
+- **For:** sound. **Fights:** Voice split across many windows where the bed should stay up between lines.
+
+### `function`
+
+A `fn ... -> video` that draws several layers as one item.
+
+- **Looks:** A grouped card, lower third or scene that moves, fades and blends as a unit.
+- **For:** edit, name, brand. **Fights:** Inputs declared outside (pass them as parameters).
+
+## Capturing real pictures
+
+Syntax and params: look-and-feel.md → Sourcing imagery, media-stdlib.md.
+
+### `page-images`
+
+The product page's own image URLs (og:image, JSON-LD Product.image, Shopify /products/<handle>.json, Amazon landingImage).
+
+- **Looks:** Real product photography: often a product on white, sometimes lifestyle shots with baked-in captions and badges.
+- **For:** prove, demo, source. **Fights:** Small sizes (Amazon gallery stills are often 500 px), baked-in text (crop it out with ffmpeg).
+
+### `screenshot`
+
+A browser screenshot of a page or app, cropped to what you need.
+
+- **Looks:** The real interface, pixel for pixel. Desktop at 1440 wide, mobile at 390 wide.
+- **For:** prove, demo, source. **Fights:** Full pages used as backgrounds (unreadable), screenshots shrunk below phone-readable size.
+
+### `screen-recording`
+
+A recording of the app or site in use, placed as an input clip.
+
+- **Looks:** The product actually working: cursor, scrolling, real states.
+- **For:** demo, prove, source. **Fights:** Long unedited takes (trim to the moment), tiny UI in a 9:16 frame.
+
+### `grabFrame`
+
+A still pulled from a video at a time (`media.grabFrame`).
+
+- **Looks:** One frame of the footage, usable as a poster or held shot.
+- **For:** source, edit. **Fights:** Motion-blurred frames.
+
+### `image-sequence`
+
+A numbered sequence of stills played as a clip.
+
+- **Looks:** Frame-by-frame animation or a timelapse from stills.
+- **For:** source, texture. **Fights:** Sequences without a declared count on hosted renders.
+
+### `made-background`
+
+A background you render yourself with ffmpeg: a gradient, a glow, a blurred copy of a shot.
+
+- **Looks:** A soft colour field in the brand palette: atmosphere without a subject.
+- **For:** texture, establish. **Fights:** Being the only picture when the subject has real imagery available.
+
+## Generated and imported media
+
+Syntax and params: ai-models.md, tts.md, music.md.
+
+### `xai.image(…)`
+
+A generated still image from a prompt (Grok).
+
+- **Looks:** Whatever you describe: a photographic or illustrated still at the aspect you ask for. Static unless you move it.
+- **For:** establish, source, texture. **Fights:** Facts: it invents products, places and people. Never use it to show the real product.
+- **Fit:** Prompts must forbid text, letters, logos and watermarks; put copy in `text`. Billed per call and cached; non-deterministic: the same prompt gives a different result unless the cache hits.
+- **Also called:** `xai.generateImage(…)`
+
+### `xai.imagine(…)`
+
+A generated video clip from a prompt (Grok), 720p, about 5 s.
+
+- **Looks:** A short cinematic clip with real camera motion and lighting; quality varies shot to shot.
+- **For:** establish, texture, source. **Fights:** Facts and specifics (logos, UI, exact products); anything that must look the same twice.
+- **Fit:** Prompts must forbid text, letters, logos and watermarks; put copy in `text`. Billed per call and cached; non-deterministic: the same prompt gives a different result unless the cache hits. Heavy: seconds to minutes per clip.
+- **Also called:** `xai.genVideo(…)`
+
+### `xai.imageToVideo(…)`
+
+Animates one still (a product photo, a screenshot) into a short clip.
+
+- **Looks:** Your picture comes alive: a camera move around it, light shifting, small motion inside it. The first frame is your image.
+- **For:** demo, establish, source. **Fights:** Images with text or UI (it warps them), when exact fidelity to the product matters.
+- **Fit:** Prompts must forbid text, letters, logos and watermarks; put copy in `text`. Billed per call and cached; non-deterministic: the same prompt gives a different result unless the cache hits.
+
+### `xai.referenceToVideo(…)`
+
+A generated clip guided by 1-7 reference images.
+
+- **Looks:** A new scene that borrows the look of your references (product, person, palette) without starting from any one of them.
+- **For:** establish, demo, source. **Fights:** Exact reproduction of the product.
+- **Fit:** Prompt required, at most 10 s. Prompts must forbid text, letters, logos and watermarks; put copy in `text`. Billed per call and cached; non-deterministic: the same prompt gives a different result unless the cache hits.
+
+### `xai.extendVideo(…)`
+
+Continues an existing clip.
+
+- **Looks:** More of the same shot: the motion carries on past the last frame.
+- **For:** source. **Fights:** Clips with cuts or text in them.
+- **Fit:** Billed per call and cached; non-deterministic: the same prompt gives a different result unless the cache hits.
+
+### `xai.tts(…)`
+
+A spoken voiceover from text (voices eve, ara, rex, sal, leo).
+
+- **Looks:** Nothing on screen; it sets the pace of the edit. Bind it with let and time visuals to vo.duration.
+- **For:** sound, caption. **Fights:** Dense on-screen text saying the same words (the viewer reads and listens at once).
+- **Fit:** Billed per call and cached; non-deterministic: the same prompt gives a different result unless the cache hits.
+- **Also called:** `xai.textToSpeech(…)`
+
+### `cf.image(…)`
+
+A generated still through the Cloudflare gateway (model: picks Flux, GPT Image, Recraft and others).
+
+- **Looks:** As `xai.image`, with the look of the chosen model.
+- **For:** establish, source, texture. **Fights:** Facts: it invents.
+- **Fit:** Pass model: explicitly. Prompts must forbid text, letters, logos and watermarks; put copy in `text`. Billed per call and cached; non-deterministic: the same prompt gives a different result unless the cache hits.
+- **Also called:** `cf.generateImage(…)`
+
+### `cf.video(…)`
+
+A generated video clip through the Cloudflare gateway (Veo, Runway, Pixverse, Seedance and others).
+
+- **Looks:** As `xai.imagine`, with the look of the chosen model; some models add native audio.
+- **For:** establish, texture, source. **Fights:** Facts and specifics.
+- **Fit:** Pass model: explicitly. Prompts must forbid text, letters, logos and watermarks; put copy in `text`. Billed per call and cached; non-deterministic: the same prompt gives a different result unless the cache hits.
+- **Also called:** `cf.imagine(…)`, `cf.genVideo(…)`, `cf.generateVideo(…)`
+
+### `cf.imageToVideo(…)`
+
+Animates one still through the Cloudflare gateway.
+
+- **Looks:** As `xai.imageToVideo`, with the chosen model.
+- **For:** demo, establish, source. **Fights:** Images with text or UI.
+- **Fit:** Prompts must forbid text, letters, logos and watermarks; put copy in `text`. Billed per call and cached; non-deterministic: the same prompt gives a different result unless the cache hits.
+
+### `cf.referenceToVideo(…)`
+
+A clip guided by reference images through the Cloudflare gateway.
+
+- **Looks:** As `xai.referenceToVideo`, with the chosen model.
+- **For:** establish, source. **Fights:** Exact reproduction.
+- **Fit:** Prompts must forbid text, letters, logos and watermarks; put copy in `text`. Billed per call and cached; non-deterministic: the same prompt gives a different result unless the cache hits.
+
+### `cf.extendVideo(…)`
+
+Continues a clip through the Cloudflare gateway.
+
+- **Looks:** More of the same shot: the camera move and action carry on past the last frame.
+- **For:** source. **Fights:** Clips with cuts.
+- **Fit:** Billed per call and cached; non-deterministic: the same prompt gives a different result unless the cache hits.
+
+### `eleven.music(…)`
+
+A generated instrumental or vocal music bed (ElevenLabs).
+
+- **Looks:** Nothing on screen; it sets the energy and where the cuts land.
+- **For:** sound. **Fights:** A voiceover at the same level: duck it with duck_under.
+- **Fit:** Give duration: the length you need. Billed per call and cached; non-deterministic: the same prompt gives a different result unless the cache hits.
+- **Also called:** `eleven.generateMusic(…)`, `eleven.composeMusic(…)`
+
+### `up.upscale(…)`
+
+Upscales a clip (Real-ESRGAN, or Topaz with model: "topaz").
+
+- **Looks:** The same shot with more detail: sharper edges, less mush. Generate cheap at 720p, upscale the keeper.
+- **For:** source. **Fights:** Short budgets and timelines: it is slow (minutes) and billed.
+- **Fit:** Billed per call and cached; non-deterministic: the same prompt gives a different result unless the cache hits.
+- **Also called:** `up.upscaleVideo(…)`, `up.enhance(…)`
+
+### `lottie.file(…)`
+
+Plays a Lottie or dotLottie animation file as a layer.
+
+- **Looks:** The vector animation you supply (icons, illustrations, UI motion), crisp at any size, on a transparent background; loops by default.
+- **For:** texture, demo, brand. **Fights:** Nothing intrinsic; quality is the file's.
+- **Fit:** Needs a .json or .lottie file. Options: loop, segment, fit, theme.
+- **Also called:** `lottie.asset(…)`, `lottie.json(…)`, `lottie.dotLottie(…)`