@scenerok/cli 2.2.0 → 2.3.0

package/skills/{remote → scenerok/references}/animations-catalog.md

@@ -1,6 +1,6 @@
 # Animations Catalog
 
-All `animations.<fn>(...)` blocks from `@scenerok/animations`. Total: **67** entries.
+All `animations.<fn>(...)` blocks from `@scenerok/animations`. Total: **77** entries.
 
 ```vidscript
 import animations from "@scenerok/animations"
@@ -51,7 +51,7 @@ import animations from "@scenerok/animations"
 | `liquid_glass_media_controls` | other | yes | 8s | positional: `trackTitle` · named: `trackTitle, artist` |
 | `liquid_glass_notification` | other | yes | 8s | positional: `title` · named: `title, body, messageText` |
 | `liquid_glass_widgets` | other | yes | 8s | positional: `showcaseTitle` · named: `showcaseTitle, showcaseDescription` |
-| `logo_outro` | brand | yes | 6s | positional: `tagline` · named: `tagline, url` |
+| `logo_outro` | brand | yes | 6s | positional: `tagline` · named: `tagline, url, logoUrl, brand, accent` |
 | `lower_third` | lower-third | yes | 5s | positional: `title, subtitle` · named: `title, subtitle` |
 | `lower_third_bild` | lower-third | yes | 8s | positional: `title, subtitle` · named: `title, subtitle, accent, bg` |
 | `lt_accent_underline` | lower-third | yes | 5s | positional: `title, subtitle` · named: `title, subtitle, accent, bg` |
@@ -69,6 +69,15 @@ import animations from "@scenerok/animations"
 | `news_ticker` | social-card | yes | 7s | positional: `headline` · named: `desk, time, label, headline, headlineAccent, ticker` |
 | `reddit_post` | social-card | yes | 5s | positional: `subreddit, title` · named: `subreddit, author, title, body, votes` |
 | `spotify_card` | social-card | yes | 5s | positional: `track, artist` · named: `track, artist` |
+| `text_counter_stat` | text-anim | yes | 5s | positional: `value, label` · named: `value, label, prefix, suffix, color, accent` |
+| `text_glitch_title` | text-anim | yes | 5s | positional: `text` · named: `text, color` |
+| `text_gradient_sweep` | text-anim | yes | 5s | positional: `text` · named: `text, from, to` |
+| `text_kinetic_words` | text-anim | yes | 5s | positional: `text` · named: `text, color, accent` |
+| `text_line_stack` | text-anim | yes | 5s | positional: `line1, line2` · named: `line1, line2, line3, color, accent` |
+| `text_neon_flicker` | text-anim | yes | 5s | positional: `text` · named: `text, color` |
+| `text_scramble_decode` | text-anim | yes | 5s | positional: `text` · named: `text, color, accent` |
+| `text_typewriter_quote` | text-anim | yes | 5s | positional: `text, author` · named: `text, author, color, accent` |
+| `text_word_cascade` | text-anim | yes | 5s | positional: `text` · named: `text, color, accent` |
 | `tiktok_follow` | social-card | yes | 5s | positional: `displayName, handle` · named: `displayName, handle, followers, avatarUrl, url` |
 | `ui_3d_reveal` | other | yes | 13s | positional: `heroTitle` · named: `heroTitle, outroUrl` |
 | `vfx_iphone_device` | other | yes | 15s | positional: `imageUrl` · named: `imageUrl` |
@@ -80,10 +89,138 @@ import animations from "@scenerok/animations"
 
 Blocks with `verified: no` vendor upstream demo content and may ignore user params. `scenerok validate` warns but does not error.
 
+## Text animation blocks (`text-anim` family)
+
+Hand-authored, fully parameterized text/typography animations — staggered word reveals,
+scramble decode, kinetic word-per-beat typography, gradient sweeps, typed quotes, masked
+line stacks, count-up stats, RGB-split glitch, and neon flicker. All are transparent
+overlays (composite over video/scenes), honor every param, and scale to any output size.
+Prefer these over hand-authoring when a headline/caption/stat treatment fits; see the
+`text-anim` rows in `animations-picker.md` for intent mapping.
+
+## Custom HTML (bring your own animation)
+
+`animations.custom_html(...)` renders **your own HTML/CSS/JS** through the same HyperFrames
+pipeline as the catalog blocks. Use it when no catalog block fits and you want to hand-author
+an animation (or an agent generates one) using standard web tech.
+
+```vidscript
+import animations from "@scenerok/animations"
+
+# Each call takes exactly ONE source:
+[0s .. 5s] = animations.custom_html(html: "<!doctype html>...")     # inline HTML
+[5s .. 10s] = animations.custom_html(src: "https://cdn.example.com/intro.html")  # remote URL
+[10s .. 15s] = animations.custom_html(src: "./anim/hero.html")        # local file
+[15s .. 20s] = animations.custom_html(src: "scenerok://asset/123")    # uploaded asset
+
+# Sizing, timing, and author params. designWidth/designHeight: native authoring size
+# (default = output size). timelineId: default "custom-html". Any other named arg
+# (title, accent) is forwarded to window.__BLOCK.
+[20s .. 24s] = animations.custom_html(src: "scenerok://asset/123", designWidth: 1920, designHeight: 1080, timelineId: "my-anim", title: "Q3 Launch", accent: "#3b82f6")
+```
+
+Reserved named args (consumed by custom_html, NOT forwarded to `__BLOCK`): `src, html, mode,
+designWidth, designHeight, width, height, fit, duration, timelineId, zBand, x, y, opacity,
+responsive`. Every other named arg is forwarded to `window.__BLOCK[name]` (values become strings).
+
+### Author contract (required)
+
+Custom HTML is mounted in a **sandboxed cross-origin iframe** and driven one frame at a time.
+Your HTML MUST:
+
+1. Render on a **transparent** background, sized to its declared design dimensions
+   (e.g. `html,body { width:1920px; height:1080px; background:transparent; }`).
+2. Register a **paused** GSAP timeline at `window.__timelines['<timelineId>']` (default
+   `custom-html`). The host calls `tl.seek(t, false)` per frame.
+3. Treat `window.__HF_DURATION` (seconds) as "stay PAUSED — I am in the seek-driven host".
+   Auto-play only when it is `undefined`: `if (typeof window.__HF_DURATION === "undefined") tl.play();`.
+4. Read author params from `window.__BLOCK` (e.g. `window.__BLOCK.title`).
+5. Load libraries from the pinned allowlist below (or inline their source). GSAP + Three.js
+   are allowlisted; anything else must be pasted inline in a `<script>` tag.
+
+### Allowlisted libraries (loadable via `<script src>` / `<link>`)
+
+| Library | Pinned URL |
+| --- | --- |
+| GSAP | `https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js` |
+| Three.js (jsdelivr) | `https://cdn.jsdelivr.net/npm/three@0.147.0/build/three.min.js` (+ `examples/js/…`) |
+| Three.js (cdnjs) | `https://cdnjs.cloudflare.com/ajax/libs/three.js/r128/three.min.js` |
+| Google Fonts | `https://fonts.googleapis.com/css2?family=…` (files from `fonts.gstatic.com`) |
+
+Any **seekable** library works if you register it at `window.__timelines[id]` with a
+`.seek(seconds, false)` method. anime.js needs a unit adapter: `window.__timelines={x:{seek:t=>anim.seek(t*1000)}}`.
+Purely rAF-loop libraries with no time-scrubbing will NOT render frame-by-frame.
+
+### Minimal working template (GSAP)
+
+Copy-paste starting point that satisfies the whole contract — agents authoring custom
+animations should start from this skeleton and only change the markup, styles, and tweens:
+
+```html
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=1920, height=1080" />
+  <script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    html, body { width: 1920px; height: 1080px; overflow: hidden; background: transparent; }
+    #hero { position: absolute; inset: 0; display: flex; align-items: center;
+            justify-content: center; font: 900 160px system-ui; color: #fff; }
+  </style>
+</head>
+<body>
+  <div id="hero"></div>
+  <script>
+    (function () {
+      // 1. Params arrive via window.__BLOCK (every extra named arg, stringified).
+      var B = window.__BLOCK || {};
+      document.getElementById('hero').textContent = B.title || 'Hello';
+
+      // 2. Build a PAUSED timeline; the host drives it with tl.seek(t, false) per frame.
+      window.__timelines = window.__timelines || {};
+      var tl = gsap.timeline({ paused: true });
+      tl.from('#hero', { opacity: 0, y: 80, duration: 0.8, ease: 'power3.out' }, 0);
+      tl.to('#hero', { letterSpacing: '12px', duration: 4, ease: 'none' }, 0.4);
+
+      // Optional: window.__HF_DURATION (seconds) = the mounted [start .. end] window,
+      // injected before this script runs — use it to pace beats across the full window.
+
+      window.__timelines['custom-html'] = tl;  // key must match timelineId (default 'custom-html')
+
+      // 3. Standalone preview only — inside the host __HF_DURATION exists, stay paused.
+      if (typeof window.__HF_DURATION === 'undefined') tl.play();
+    })();
+  </script>
+</body>
+</html>
+```
+
+Gotchas: CSS `animation`/`transition` run on the wall clock and are NOT seek-driven — frames
+render wrong or frozen; drive every visual change through the registered timeline (use finite
+`repeat:` counts for loops, never `repeat: -1` — an infinite timeline breaks seeking). Avoid
+`Math.random()` per frame unless keyed off seek time — the same `t` must always draw the same
+frame (renders can revisit frames out of order).
+
+### Security constraints
+
+- Cross-origin sandboxed: author JS cannot reach the parent page, other surfaces, or the canvas.
+- Strict CSP: `connect-src 'none'` — no `fetch`/`XHR`/`WebSocket` at runtime. Pass data via
+  `__BLOCK` params. Images from `data:`/`https:`. External `<script src>` blocked except the
+  allowlist above (inline other libraries). DRACO-compressed glTF unsupported (decoder fetch blocked).
+- `mode: "inline"` is not supported (cannot be sandboxed) — it is a compile error. Blend/backdrop
+  overlays stay catalog-only.
+- Max HTML size 512 KB.
+
 ## Usage
 
 ```vidscript
+import animations from "@scenerok/animations"
+
 [0s .. 6s] = animations.code_typing("const x = 1;")
+[0s .. 5s] = animations.text_word_cascade("Make videos from plain text", accent: "#60a5fa")
+[5s .. 9s] = animations.text_counter_stat("12500", "Downloads", suffix: "+")
 ```
 
 See `animations-picker.md` for intent-based selection. Preview samples: https://scenerok.com/catalog#animations

package/skills/{remote → scenerok/references}/animations-picker.md

@@ -27,8 +27,18 @@
 | Spotify now-playing | social-card | `spotify_card` | `track`, `artist` |
 | macOS notification | social-card | `macos_notification` | `appName`, `title`, `body?`, `timeLabel?` |
 | news ticker / headline crawl | social-card | `news_ticker` | `headline`, `headlineAccent?`, `ticker?`, `desk?`, `time?` |
-| logo outro / brand sting | brand | `logo_outro` | `tagline`, `url?` |
+| logo outro / brand sting | brand | `logo_outro` | `tagline`, `url?`, `brand?` (`"scenerok"` preset) or `logoUrl?`, `accent?` |
+| staggered word-reveal headline | text-anim | `text_word_cascade` | `text`, `color?`, `accent?` (accent tints last word) |
+| matrix-style decode / decrypt title | text-anim | `text_scramble_decode` | `text`, `color?`, `accent?` |
+| word-per-beat kinetic typography | text-anim | `text_kinetic_words` | `text` (space-separated words), `color?`, `accent?` |
+| animated gradient headline | text-anim | `text_gradient_sweep` | `text`, `from?`, `to?` (gradient colors) |
+| typed quote with attribution | text-anim | `text_typewriter_quote` | `text`, `author`, `color?`, `accent?` |
+| 2–3 line masked title stack | text-anim | `text_line_stack` | `line1`, `line2`, `line3?`, `accent?` |
+| count-up stat / metric | text-anim | `text_counter_stat` | `value`, `label`, `prefix?`, `suffix?`, `accent?` |
+| RGB-split glitch title | text-anim | `text_glitch_title` | `text`, `color?` |
+| neon sign flicker-on | text-anim | `text_neon_flicker` | `text`, `color?` (glow color) |
 | punchy kinetic title (no block) | kinetic-type | (use `text` + `motion.*` — see `text-styles.md`) | — |
+| no catalog block fits / author your own animation (HTML+CSS with GSAP, Three.js, or any seekable JS lib) | custom | `custom_html` | `src` or `html` — author contract, allowlisted libraries, and a minimal GSAP template in `animations-catalog.md` → "Custom HTML" |
 
 Param resolution: **named > positional > default**.
 
@@ -40,6 +50,7 @@ Param resolution: **named > positional > default**.
 | Unverified blocks | `scenerok validate` warns `verified:false` | Accept demo render or switch to verified family |
 | Maps / liquid-glass / app-showcase | Ignore user params | Use for demo aesthetic only, or hand-author |
 | Adapter blocks | No inline audio/text siblings | Put `audio`, `text`, `filter` on separate time blocks |
+| `logo_outro` | Renders upstream demo's Figma-style mark when no logo param given | Pass `brand: "scenerok"` or `logoUrl: "<image url>"` |
 
 ## Two-phase compose recipe
 

package/skills/{remote → scenerok/references}/brand-setup.md

@@ -34,11 +34,13 @@ let brandColor = "#6366F1"
 
 [0s .. 3s] = text "Launch Week", color: brandColor, style: title, animate: motion.popIn(0.6s)
 [3s .. 8s] = animations.lt_clean_bar("Product Name", "Tagline here", accent: brandColor)
-[8s .. 14s] = animations.logo_outro("Thanks for watching", url: "scenerok.com")
+[8s .. 14s] = animations.logo_outro("Thanks for watching", url: "scenerok.com", logoUrl: logo)
 ```
 
 Use `accent`, `accentColor`, and `color` params consistently across text and animation blocks.
 
+**`logo_outro` branding:** without `logoUrl` or `brand`, the outro renders the upstream demo's colorful Figma-style mark — never ship that on a branded video. Pass `logoUrl:` (user's logo image) or `brand: "scenerok"` (built-in SceneRok preset, also tints the glow), plus `accent:` to override the glow color.
+
 ## Per-environment collection
 
 | Environment | How to get brand assets |

package/skills/{remote → scenerok/references}/catalog-index.json

@@ -1,6 +1,6 @@
 {
   "schema": "https://scenerok.com/catalog-index/v1",
-  "generatedAt": "2026-07-03T01:54:50.808Z",
+  "generatedAt": "2026-10-06T08:56:17.740Z",
   "cdnBase": "https://assets-public.scenerok.com/catalog",
   "categories": [
     {
@@ -283,10 +283,10 @@
             {
               "id": "animations:code_particle_assemble",
               "title": "Default",
-              "description": "3s sample at 720×1280.",
-              "durationSeconds": 3,
-              "vidscript": "import animations from \"@scenerok/animations\"\n\n[0s .. 3s] = animations.code_particle_assemble(\"[0s .. 3s] = video xai.imagine('let there be light')\")",
-              "mp4Url": "https://assets-public.scenerok.com/catalog/animations__code_particle_assemble.mp4?v=f76081fa",
+              "description": "6s sample at 720×1280.",
+              "durationSeconds": 6,
+              "vidscript": "import animations from \"@scenerok/animations\"\n\n[0s .. 6s] = animations.code_particle_assemble(\"[0s .. 3s] = video xai.imagine('let there be light')\")",
+              "mp4Url": "https://assets-public.scenerok.com/catalog/animations__code_particle_assemble.mp4?v=5666582a",
               "posterUrl": "https://assets-public.scenerok.com/catalog/posters/animations__code_particle_assemble.jpg?v=882b1fd3"
             }
           ]
@@ -766,8 +766,8 @@
               "description": "3s sample at 720×1280.",
               "durationSeconds": 3,
               "vidscript": "import animations from \"@scenerok/animations\"\n\n[0s .. 3s] = animations.ios26_liquid_glass()",
-              "mp4Url": null,
-              "posterUrl": null
+              "mp4Url": "https://assets-public.scenerok.com/catalog/animations__ios26_liquid_glass.mp4?v=f9f046f0",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/animations__ios26_liquid_glass.jpg?v=e8acf8fa"
             }
           ]
         },
@@ -798,8 +798,8 @@
               "description": "3s sample at 720×1280.",
               "durationSeconds": 3,
               "vidscript": "import animations from \"@scenerok/animations\"\n\n[0s .. 3s] = animations.liquid_glass_media_controls(\"Sample\")",
-              "mp4Url": null,
-              "posterUrl": null
+              "mp4Url": "https://assets-public.scenerok.com/catalog/animations__liquid_glass_media_controls.mp4?v=24d2c880",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/animations__liquid_glass_media_controls.jpg?v=059d4897"
             }
           ]
         },
@@ -1038,8 +1038,8 @@
               "description": "3s sample at 720×1280.",
               "durationSeconds": 3,
               "vidscript": "import animations from \"@scenerok/animations\"\n\n[0s .. 3s] = animations.lt_stack_bars(\"Jane Doe\", \"Engineer\")",
-              "mp4Url": null,
-              "posterUrl": null
+              "mp4Url": "https://assets-public.scenerok.com/catalog/animations__lt_stack_bars.mp4?v=be9b5b4f",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/animations__lt_stack_bars.jpg?v=12d6f346"
             }
           ]
         },
@@ -1070,8 +1070,8 @@
               "description": "3s sample at 720×1280.",
               "durationSeconds": 3,
               "vidscript": "import animations from \"@scenerok/animations\"\n\n[0s .. 3s] = animations.macos_tahoe_liquid_glass(\"Sample\")",
-              "mp4Url": null,
-              "posterUrl": null
+              "mp4Url": "https://assets-public.scenerok.com/catalog/animations__macos_tahoe_liquid_glass.mp4?v=7bc0b4f8",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/animations__macos_tahoe_liquid_glass.jpg?v=e8acf8fa"
             }
           ]
         },
@@ -1123,6 +1123,150 @@
             }
           ]
         },
+        {
+          "id": "text-counter-stat",
+          "title": "Text Counter Stat",
+          "description": "@scenerok/animations.text_counter_stat() — text-counter-stat composition.",
+          "examples": [
+            {
+              "id": "animations:text_counter_stat",
+              "title": "Default",
+              "description": "3s sample at 720×1280.",
+              "durationSeconds": 3,
+              "vidscript": "import animations from \"@scenerok/animations\"\n\n[0s .. 3s] = animations.text_counter_stat(\"12500\", \"Downloads\")",
+              "mp4Url": "https://assets-public.scenerok.com/catalog/animations__text_counter_stat.mp4?v=648434e3",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/animations__text_counter_stat.jpg?v=19723b34"
+            }
+          ]
+        },
+        {
+          "id": "text-glitch-title",
+          "title": "Text Glitch Title",
+          "description": "@scenerok/animations.text_glitch_title() — text-glitch-title composition.",
+          "examples": [
+            {
+              "id": "animations:text_glitch_title",
+              "title": "Default",
+              "description": "3s sample at 720×1280.",
+              "durationSeconds": 3,
+              "vidscript": "import animations from \"@scenerok/animations\"\n\n[0s .. 3s] = animations.text_glitch_title(\"SYSTEM ONLINE\")",
+              "mp4Url": "https://assets-public.scenerok.com/catalog/animations__text_glitch_title.mp4?v=b2bec3e7",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/animations__text_glitch_title.jpg?v=6f819736"
+            }
+          ]
+        },
+        {
+          "id": "text-gradient-sweep",
+          "title": "Text Gradient Sweep",
+          "description": "@scenerok/animations.text_gradient_sweep() — text-gradient-sweep composition.",
+          "examples": [
+            {
+              "id": "animations:text_gradient_sweep",
+              "title": "Default",
+              "description": "3s sample at 720×1280.",
+              "durationSeconds": 3,
+              "vidscript": "import animations from \"@scenerok/animations\"\n\n[0s .. 3s] = animations.text_gradient_sweep(\"Gradient in Motion\")",
+              "mp4Url": "https://assets-public.scenerok.com/catalog/animations__text_gradient_sweep.mp4?v=fa7aee38",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/animations__text_gradient_sweep.jpg?v=c1d2c734"
+            }
+          ]
+        },
+        {
+          "id": "text-kinetic-words",
+          "title": "Text Kinetic Words",
+          "description": "@scenerok/animations.text_kinetic_words() — text-kinetic-words composition.",
+          "examples": [
+            {
+              "id": "animations:text_kinetic_words",
+              "title": "Default",
+              "description": "3s sample at 720×1280.",
+              "durationSeconds": 3,
+              "vidscript": "import animations from \"@scenerok/animations\"\n\n[0s .. 3s] = animations.text_kinetic_words(\"BIG BOLD FAST TYPE\")",
+              "mp4Url": "https://assets-public.scenerok.com/catalog/animations__text_kinetic_words.mp4?v=15009872",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/animations__text_kinetic_words.jpg?v=4f2a7d46"
+            }
+          ]
+        },
+        {
+          "id": "text-line-stack",
+          "title": "Text Line Stack",
+          "description": "@scenerok/animations.text_line_stack() — text-line-stack composition.",
+          "examples": [
+            {
+              "id": "animations:text_line_stack",
+              "title": "Default",
+              "description": "3s sample at 720×1280.",
+              "durationSeconds": 3,
+              "vidscript": "import animations from \"@scenerok/animations\"\n\n[0s .. 3s] = animations.text_line_stack(\"Build videos\", \"from plain text\")",
+              "mp4Url": "https://assets-public.scenerok.com/catalog/animations__text_line_stack.mp4?v=d11dc02f",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/animations__text_line_stack.jpg?v=9c85faca"
+            }
+          ]
+        },
+        {
+          "id": "text-neon-flicker",
+          "title": "Text Neon Flicker",
+          "description": "@scenerok/animations.text_neon_flicker() — text-neon-flicker composition.",
+          "examples": [
+            {
+              "id": "animations:text_neon_flicker",
+              "title": "Default",
+              "description": "3s sample at 720×1280.",
+              "durationSeconds": 3,
+              "vidscript": "import animations from \"@scenerok/animations\"\n\n[0s .. 3s] = animations.text_neon_flicker(\"OPEN LATE\")",
+              "mp4Url": "https://assets-public.scenerok.com/catalog/animations__text_neon_flicker.mp4?v=028f1626",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/animations__text_neon_flicker.jpg?v=861a2569"
+            }
+          ]
+        },
+        {
+          "id": "text-scramble-decode",
+          "title": "Text Scramble Decode",
+          "description": "@scenerok/animations.text_scramble_decode() — text-scramble-decode composition.",
+          "examples": [
+            {
+              "id": "animations:text_scramble_decode",
+              "title": "Default",
+              "description": "3s sample at 720×1280.",
+              "durationSeconds": 3,
+              "vidscript": "import animations from \"@scenerok/animations\"\n\n[0s .. 3s] = animations.text_scramble_decode(\"DECODING THE SIGNAL\")",
+              "mp4Url": "https://assets-public.scenerok.com/catalog/animations__text_scramble_decode.mp4?v=5578cf99",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/animations__text_scramble_decode.jpg?v=48bf0bbe"
+            }
+          ]
+        },
+        {
+          "id": "text-typewriter-quote",
+          "title": "Text Typewriter Quote",
+          "description": "@scenerok/animations.text_typewriter_quote() — text-typewriter-quote composition.",
+          "examples": [
+            {
+              "id": "animations:text_typewriter_quote",
+              "title": "Default",
+              "description": "3s sample at 720×1280.",
+              "durationSeconds": 3,
+              "vidscript": "import animations from \"@scenerok/animations\"\n\n[0s .. 3s] = animations.text_typewriter_quote(\"Simplicity is the ultimate sophistication.\", \"Leonardo da Vinci\")",
+              "mp4Url": "https://assets-public.scenerok.com/catalog/animations__text_typewriter_quote.mp4?v=c4c64c37",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/animations__text_typewriter_quote.jpg?v=fe5b8624"
+            }
+          ]
+        },
+        {
+          "id": "text-word-cascade",
+          "title": "Text Word Cascade",
+          "description": "@scenerok/animations.text_word_cascade() — text-word-cascade composition.",
+          "examples": [
+            {
+              "id": "animations:text_word_cascade",
+              "title": "Default",
+              "description": "3s sample at 720×1280.",
+              "durationSeconds": 3,
+              "vidscript": "import animations from \"@scenerok/animations\"\n\n[0s .. 3s] = animations.text_word_cascade(\"Make videos from plain text\")",
+              "mp4Url": "https://assets-public.scenerok.com/catalog/animations__text_word_cascade.mp4?v=2eca3c74",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/animations__text_word_cascade.jpg?v=593328b5"
+            }
+          ]
+        },
         {
           "id": "tiktok-follow",
           "title": "Tiktok Follow",
@@ -1708,8 +1852,8 @@
               "description": "Product launch energy.",
               "durationSeconds": 3,
               "vidscript": "import xai from \"@scenerok/xai\"\n\n[0s .. 3s] = text \"GO.\", font: \"Inter Black\", size: 240, color: \"#FF3B3B\", align: \"center\"\n[0s .. 3s] = audio xai.tts(\"Ship it. Right now.\", voice: \"leo\")",
-              "mp4Url": null,
-              "posterUrl": null
+              "mp4Url": "https://assets-public.scenerok.com/catalog/tts__energetic-vo-hype.mp4?v=4ca84baf",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/tts__energetic-vo-hype.jpg?v=3f79ffad"
             },
             {
               "id": "tts:energetic-vo",
@@ -1717,8 +1861,8 @@
               "description": "Punchy three-beat hook.",
               "durationSeconds": 3,
               "vidscript": "import xai from \"@scenerok/xai\"\n\n[0s .. 3s] = text \"Drop it.\", font: \"Inter Black\", size: 198, color: \"#FFD23F\", align: \"center\"\n[0s .. 3s] = audio xai.tts(\"Three. Two. One. Drop it.\", voice: \"rex\")",
-              "mp4Url": null,
-              "posterUrl": null
+              "mp4Url": "https://assets-public.scenerok.com/catalog/tts__energetic-vo.mp4?v=e078344b",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/tts__energetic-vo.jpg?v=f4f999e3"
             }
           ]
         },
@@ -1733,8 +1877,8 @@
               "description": "Single sentence under a headline.",
               "durationSeconds": 3,
               "vidscript": "import xai from \"@scenerok/xai\"\n\n[0s .. 3s] = text \"Listen.\", font: \"Inter\", size: 120, color: \"#9FB6FF\", align: \"center\"\n[0s .. 3s] = audio xai.tts(\"One line of voice-over, baked into the mix.\", voice: \"ara\")",
-              "mp4Url": null,
-              "posterUrl": null
+              "mp4Url": "https://assets-public.scenerok.com/catalog/tts__narrator-calm.mp4?v=7fbac622",
+              "posterUrl": "https://assets-public.scenerok.com/catalog/posters/tts__narrator-calm.jpg?v=ba591a7b"
             },
             {
               "id": "tts:narrator",