@scenerok/cli 2.2.0

package/skills/remote/text-styles.md

@@ -0,0 +1,108 @@
+# Text Styles and Motion Primitives
+
+`import motion from "@scenerok/basic-animations"` — use with `animate:` on VidScript `text` blocks.
+
+In **TypeScript SDK**, use the built-in motion helpers from `@scenerok/sdk` (`fadeIn`, `fadeOut`, `slideY`, `slideX`, `scale`, `popIn`) and place text with `area` / `t.grid` (see `sdk-guide.md`).
+
+## Motion primitives
+
+| Primitive | Suits | Phase | SDK helper |
+| --- | --- | --- | --- |
+| `motion.fadeIn` | subtle entrance | entry | `fadeIn(s(0.4))` |
+| `motion.fadeOut` | ending / cut-to-black | exit | `fadeOut(s(0.4))` |
+| `motion.slideX` | horizontal reveal | entry | `slideX(...)` |
+| `motion.slideY` | vertical rise / fall | entry | `slideY(...)` |
+| `motion.popIn` | impact / hero reveal | entry | `popIn(...)` |
+| `motion.riseIn` | title build-up | entry | — (VidScript) |
+| `motion.swingIn` | playful entrance | entry | — (VidScript) |
+| `motion.glitchIn` | energetic entrance | entry | — (VidScript) |
+| `motion.float` | idle ambient drift | idle | — (VidScript) |
+| `motion.typewriter` | technical typing reveal | entry | — (VidScript) |
+
+## Grid areas (both languages)
+
+Prefer named regions over hand-picked `x`/`y`:
+
+```vidscript
+[0 .. 3] = text "BIG SALE", area: "title", animate: motion.popIn(0.8)
+```
+
+```ts
+import { timeline, text, s, popIn } from '@scenerok/sdk'
+
+const t = timeline({ width: 1080, height: 1920, fps: 30 })
+t.grid({ rows: '16% 1fr 18% 10%', areas: ['title', 'stage', 'lower-third', 'caption'] })
+t[0][s(3)] = text('BIG SALE', { size: 72, area: 'title' }).animate(popIn(s(0.8)))
+```
+
+Built-in areas (no grid declaration): `title`, `stage`, `lower-third`, `caption`.
+
+## Examples (VidScript)
+
+### Bold hero headline
+
+Large sans-serif with shadow and fade entrance/exit.
+
+**Center pop** — popIn entrance on a dark canvas.
+
+```vidscript
+import motion from "@scenerok/basic-animations"
+
+[0s .. 3s] = text "SCENEROK", font: "Inter Black", size: 200, color: "#7CFAC7", align: "center", letter_spacing: 6, animate: [motion.popIn(0.8), motion.fadeOut(0.5)]
+```
+
+**Bottom-anchored** — position: "bottom", motion.fadeIn + fadeOut.
+
+```vidscript
+import motion from "@scenerok/basic-animations"
+
+[0s .. 3s] = text "Make videos from text.", font: "Inter Bold", size: 96, color: "#FFFFFF", position: "bottom", align: "center", shadow_color: "#000000", shadow_blur: 16, x: "50%", y: -180, animate: [motion.fadeIn(0.6), motion.fadeOut(0.6)]
+```
+
+### Motion presets
+
+Composable motion.fadeIn, popIn, and float descriptors.
+
+**Fade in + out** — motion.fadeIn(0.5) + motion.fadeOut(0.5).
+
+```vidscript
+import motion from "@scenerok/basic-animations"
+
+[0s .. 3s] = text "FADE", font: "Inter Black", size: 220, color: "#FFFFFF", align: "center", animate: [motion.fadeIn(0.5), motion.fadeOut(0.5)]
+```
+
+**Pop + float** — popIn(0.7) then float(2.2, 12).
+
+```vidscript
+import motion from "@scenerok/basic-animations"
+
+[0s .. 3s] = text "POP", font: "Inter Black", size: 220, color: "#FFD7A0", align: "center", animate: [motion.popIn(0.7), motion.float(2.2, 12)]
+```
+
+### Typewriter reveal
+
+motion.typewriter() reveals characters one at a time.
+
+**Slow sans** — Inter, white, longer typewriter duration.
+
+```vidscript
+import motion from "@scenerok/basic-animations"
+
+[0s .. 3s] = text "Type. Render. Ship.", font: "Inter", size: 72, color: "#FFFFFF", align: "center", animate: [motion.typewriter(1.8), motion.fadeOut(0.4)]
+```
+
+**Mono terminal** — JetBrains Mono, mint green on black.
+
+```vidscript
+import motion from "@scenerok/basic-animations"
+
+[0s .. 3s] = text "build videos from text.", font: "JetBrains Mono", size: 58, color: "#7CFAC7", align: "center", animate: [motion.typewriter(1.6), motion.fadeOut(0.3)]
+```
+
+Kinetic titles with no HyperFrames block → `text` + `animate: motion.<primitive>`.
+
+Richer pre-built text treatments (staggered word reveals, scramble decode, kinetic
+word-per-beat typography, gradient sweeps, typed quotes, count-up stats, glitch, neon) →
+`animations.text_*` blocks — see the `text-anim` rows in `animations-picker.md`.
+Fully custom text animation (your own HTML/CSS/GSAP) → `animations.custom_html` in
+`animations-catalog.md`.

package/skills/remote/transitions-catalog.md

@@ -0,0 +1,55 @@
+# Transitions Catalog
+
+All `tr.<fn>(...)` scene transitions from `@scenerok/transitions`. Total: **29** shaders.
+
+## Binding semantics
+
+A transition window `[Ts .. Te]` binds the clip active at **Ts** (from) and **Te** (to):
+
+```vidscript
+import tr from "@scenerok/transitions"
+
+[0s .. 5s]   = video clip_a
+[5s .. 5.6s] = tr.dissolve()
+[5.6s .. 10s] = video clip_b
+```
+
+Common params: `direction`, `ease`, `strength`, `mode`.
+
+| fn | shader | defaultDuration |
+| --- | --- | --- |
+| `dissolve` | `dissolve` | 0.6s |
+| `push` | `push` | 0.6s |
+| `cover` | `cover` | 0.6s |
+| `radial` | `radial` | 0.6s |
+| `grid` | `grid` | 0.6s |
+| `scale` | `scale` | 0.6s |
+| `cube` | `cube` | 0.6s |
+| `blur` | `blur` | 0.6s |
+| `distortion` | `distortion` | 0.6s |
+| `destruction` | `destruction` | 0.6s |
+| `light` | `light` | 0.6s |
+| `mechanical` | `mechanical` | 0.6s |
+| `wipe` | `wipe` | 0.6s |
+| `cinematic_zoom` | `cinematic_zoom` | 0.6s |
+| `whip_pan` | `whip_pan` | 0.6s |
+| `light_leak` | `light_leak` | 0.6s |
+| `flash` | `flash` | 0.6s |
+| `warp_morph` | `warp_morph` | 0.6s |
+| `domain_warp` | `domain_warp` | 0.6s |
+| `chromatic_split` | `chromatic_split` | 0.6s |
+| `lens` | `lens` | 0.6s |
+| `glitch` | `glitch` | 0.6s |
+| `swirl` | `swirl` | 0.6s |
+| `thermal` | `thermal` | 0.6s |
+| `ripple` | `ripple` | 0.6s |
+| `iris` | `iris` | 0.6s |
+| `burn` | `burn` | 0.6s |
+| `shatter` | `shatter` | 0.6s |
+| `liquid` | `liquid` | 0.6s |
+
+## VFX filters (single-clip)
+
+See `shaders-filters.md` for `filter "liquid_glass"`, `magnetic`, `portal`, `text_cursor`.
+
+Preview: https://scenerok.com/catalog#transitions

package/skills/remote/tts.md

@@ -0,0 +1,82 @@
+# Text-to-Speech
+
+`import xai from "@scenerok/xai"` — voiceover via `xai.tts(...)`.
+
+Voice IDs: `eve` (upbeat), `ara` (warm), `rex` (business), `sal` (balanced), `leo` (authoritative).
+Catalog samples may use `Marin`, `Hudson` — check `xai.listVoices()` for current IDs.
+
+### VidScript
+
+```vidscript
+import xai from "@scenerok/xai"
+let vo = xai.tts("Welcome to SceneRok", voice: "eve")
+[0 .. vo.duration] = audio vo
+```
+
+### TypeScript SDK
+
+```ts
+import { timeline, text, s } from '@scenerok/sdk'
+import xai from '@scenerok/xai'
+
+export default async function main() {
+  const t = timeline({ width: 1080, height: 1920, fps: 30 })
+  const vo = await xai.tts('Welcome to SceneRok', { voice: 'eve' })
+  t.push(vo)
+  t[0][vo.duration] = text('Welcome', { size: 64, area: 'title' })
+  return t.toIR()
+}
+```
+
+**Never guess a TTS window.** You cannot know the audio length while writing the script. VidScript: assign with `let` and use `vo.duration`, or `[-] = audio xai.tts(...)`. SDK: `await xai.tts(...)` then use `vo.duration` / `t.push(vo)`. Guessed ranges like `[0s .. 3s] = audio xai.tts("long sentence...")` clip or collide when the real audio runs longer.
+
+Chain multiple lines with symbolic arithmetic:
+
+```vidscript
+let vo1 = xai.tts("First line", voice: "eve")
+let vo2 = xai.tts("Second line", voice: "eve")
+[0 .. vo1.duration] = audio vo1
+[vo1.duration + 0.3 .. vo1.duration + 0.3 + vo2.duration] = audio vo2
+[0 .. vo1.duration] = text "First headline", area: "title"   # visual spans the narration
+```
+
+## Examples (VidScript)
+
+Catalog samples below use fixed example windows; in real scripts prefer `vo.duration` or `[-]` blocks as shown above.
+
+**Leo — launch** — Product launch energy.
+
+```vidscript
+import xai from "@scenerok/xai"
+
+[0s .. 3s] = text "GO.", font: "Inter Black", size: 240, color: "#FF3B3B", align: "center"
+[0s .. 3s] = audio xai.tts("Ship it. Right now.", voice: "leo")
+```
+
+**Rex — countdown** — Punchy three-beat hook.
+
+```vidscript
+import xai from "@scenerok/xai"
+
+[0s .. 3s] = text "Drop it.", font: "Inter Black", size: 198, color: "#FFD23F", align: "center"
+[0s .. 3s] = audio xai.tts("Three. Two. One. Drop it.", voice: "rex")
+```
+
+**Ara — short line** — Single sentence under a headline.
+
+```vidscript
+import xai from "@scenerok/xai"
+
+[0s .. 3s] = text "Listen.", font: "Inter", size: 120, color: "#9FB6FF", align: "center"
+[0s .. 3s] = audio xai.tts("One line of voice-over, baked into the mix.", voice: "ara")
+```
+
+**Eve — narrative** — Long-form explanatory copy.
+
+```vidscript
+import xai from "@scenerok/xai"
+
+[0s .. 3s] = text "Voice from text.", font: "Inter Bold", size: 64, color: "#FFFFFF", align: "center"
+[0s .. 3s] = audio xai.tts("Vidscript turns plain text into a fully rendered video. No timeline editing required.", voice: "eve")
+```
+