@scenerok/cli 1.0.5 → 1.0.6

package/skills/codex/vidscript-guide.md

@@ -4,18 +4,20 @@ VidScript is a declarative DSL for composing short-form videos. Write a script,
 
 ## Agent quick start (read before composing)
 
-1. **Import plugins** — `import xai from "@scenerok/xai"` before `xai.imagine`, `xai.tts`, or `animate: fadeIn(...)`.
+1. **Import every package function** — use `import xai from "@scenerok/xai"`, `import eleven from "@elevenlabs/music"`, and `import motion from "@scenerok/basic-animations"` before calling `xai.*`, `eleven.*`, or `motion.*`.
 2. **Validate early** — `scenerok validate file.vid` (errors show as `Line N:C — message`).
-3. **Copy working examples** — see `examples/system/` in this skill folder (e.g. `minimal-text-reel.vid`, `ecom-product-launch.vid`, `rokmilk-chocolate-promo.vid`).
-4. **Strict rules** — see `vidscript-strict.md` for invalid patterns (bare `xai.imagine`, `audio music(...), volume:`, nested quotes in prompts).
+3. **Music package syntax** — `import eleven from "@elevenlabs/music"`, then call `eleven.music(...)`, `eleven.generateMusic(...)`, or `eleven.composeMusic(...)`.
+4. **Copy working examples** — see `examples/system/` in this skill folder (e.g. `minimal-text-reel.vid`, `ecom-product-launch.vid`, `rokmilk-chocolate-promo.vid`).
+5. **Strict rules** — see `vidscript-strict.md` for invalid patterns (bare `xai.imagine`, bare `eleven.music(...)` without import, trailing params after direct plugin calls, nested quotes in prompts).
 
 ### Common validation failures
 
 | Symptom | Fix |
 |---------|-----|
 | `Unknown function 'xai.imagine'` | Add `import xai from "@scenerok/xai"` at top |
-| `Unknown function 'fadeIn'` | Same import (animation helpers are plugin-backed) |
-| `Expected ... but "," found` | Do not put `, volume:` after a plugin call on the same line |
+| `Unknown function 'fadeIn'` | Use `import motion from "@scenerok/basic-animations"` and call `motion.fadeIn(...)` |
+| `Expected ... but "," found` | Do not put `, volume:` after a direct plugin call. Use `let bed = eleven.music(...)`, then `audio bed, volume: ...` |
+| `Unknown function 'eleven.generateMusic'` | Add `import eleven from "@elevenlabs/music"` before calling `eleven.generateMusic(...)` |
 | Parse error on imagine prompt | Remove nested `"` quotes inside the prompt string |
 
 ## Program Structure
@@ -66,28 +68,18 @@ let clipName = "hero"
 
 Variables can hold strings, numbers, time literals, and object expressions. Variables are evaluated at compile time.
 
-### Import / Export (Module System)
+### Package Imports
 
-```vidscript
-# Export a constant
-export const BRAND_COLOR = "#FF5733"
-
-# Export a timeline
-export timeline intro(clip: string, title_text: string) {
-  [-] = clip
-  [- 2s] = text title_text, size: 72
-}
+Only default package imports are supported for callable packages. Call functions through the imported alias.
 
-# Import from another file
-import { intro, BRAND_COLOR } from "./timelines.vid"
-
-# Import namespace
-import * as transitions from "@scenerok/transitions"
-
-# Use a timeline
-use intro at 0s .. 5s with { clip: hero, title_text: "Hello" }
+```vidscript
+import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+import motion from "@scenerok/basic-animations"
 ```
 
+Named imports (`import { fn } ...`) and namespace imports (`import * as ...`) are not supported.
+
 ## Time Blocks
 
 Time blocks are the core of VidScript. They define when instructions execute on the timeline.
@@ -238,19 +230,28 @@ Audio sources can be MP3 inputs, audio plugin results, or the embedded audio str
 
 ```vidscript
 import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+import motion from "@scenerok/basic-animations"
 
 [-] = video xai.imagine("Cinematic product shot", aspect_ratio: "9:16", duration: 5)
 [-] = audio xai.tts("Welcome to SceneRok", voice: "eve")
+
+# ElevenLabs music package functions require an import alias.
+[0s .. 15s] = audio eleven.music("Warm premium launch bed", duration: 15, instrumental: true)
+
+# If you need volume or fades, store the generated audio first.
+let bed = eleven.music("Warm premium launch bed", duration: 15, instrumental: true)
+[0s .. 15s] = audio bed, volume: 0.35, fade_out: 2s
 ```
 
-Plugins require an explicit default import. The server registers `@scenerok/xai` when API keys are configured. Plugin calls run at compile time and must appear **inside time blocks**, not in `let` assignments.
+`@scenerok/xai` requires an explicit default import. ElevenLabs music validates as `eleven.music(...)`, `eleven.generateMusic(...)`, or `eleven.composeMusic(...)` after `import eleven from "@elevenlabs/music"`. Plugin calls run at compile time; direct media plugin instructions cannot have trailing audio params, so use a `let` binding when you need `volume`, `fade_in`, or `fade_out`.
 
 **Invalid (will not validate):**
 
 ```vidscript
-[-] = video xai.imagine("...")          # missing import
-[-] = audio music("..."), volume: 0.5   # trailing params after plugin call
-let clip = xai.imagine("...")           # plugin assigned to variable
+[-] = video xai.imagine("...")                    # missing xAI import
+[0s .. 15s] = audio eleven.generateMusic("...")   # missing `import eleven from "@elevenlabs/music"`
+[0s .. 15s] = audio eleven.music("..."), volume: 0.5      # trailing params after direct plugin call
 ```
 
 ## Animations, Effects & Plugins (v2 Extensibility)
@@ -269,9 +270,11 @@ These accept either plugin function calls or plain object descriptors.
 Attach animations to **any** text or video surface.
 
 ```vidscript
-text "Hello", animate: fadeIn(0.8s)
+import motion from "@scenerok/basic-animations"
+
+text "Hello", animate: motion.fadeIn(0.8s)
 
-video hero, animate: [fadeIn(0.5s), slideY(-40, 0, 1.2s)]
+video hero, animate: [motion.fadeIn(0.5s), motion.slideY(-40, 0, 1.2s)]
 
 text "Title", animate: {
   type: "fade",
@@ -299,16 +302,16 @@ video hero, effects: [{
 
 | Function                  | Description                  |
 |---------------------------|------------------------------|
-| `fadeIn(duration?)`       | Opacity 0 → 1                |
-| `fadeOut(duration?)`      | Opacity 1 → 0                |
-| `slideX(from, to, dur?)`  | Horizontal slide             |
-| `slideY(from, to, dur?)`  | Vertical slide               |
-| `popIn(duration?)`        | Scale + fade entrance        |
-| `riseIn(duration?, dist?)` | Upward fade entrance         |
-| `swingIn(duration?)`      | Rotating slide/fade         |
-| `glitchIn(duration?)`     | Jitter + flash entrance      |
-| `float(duration?, amp?)`   | Gentle vertical bob          |
-| `typewriter(duration?)`   | Character reveal             |
+| `motion.fadeIn(duration?)`       | Opacity 0 → 1                |
+| `motion.fadeOut(duration?)`      | Opacity 1 → 0                |
+| `motion.slideX(from, to, dur?)`  | Horizontal slide             |
+| `motion.slideY(from, to, dur?)`  | Vertical slide               |
+| `motion.popIn(duration?)`        | Scale + fade entrance        |
+| `motion.riseIn(duration?, dist?)` | Upward fade entrance         |
+| `motion.swingIn(duration?)`      | Rotating slide/fade         |
+| `motion.glitchIn(duration?)`     | Jitter + flash entrance      |
+| `motion.float(duration?, amp?)`   | Gentle vertical bob          |
+| `motion.typewriter(duration?)`   | Character reveal             |
 
 More plugins (advanced text animations, pixel effects, 3D, etc.) are planned.
 

package/skills/codex/vidscript-sample.md

@@ -4,14 +4,15 @@ Copy this shape for promos that use xAI-generated clips. Run `scenerok validate`
 
 ```vidscript
 import xai from "@scenerok/xai"
+import motion from "@scenerok/basic-animations"
 
 input product_name = "{{product_name | RokMilk}}"
 input hook_text = "{{hook_text | Chocolate Milkshake}}"
 input cta_text = "{{cta_text | visit your nearest grocery store}}"
 
-[0s .. 2.5s] = text product_name, font: "Bebas Neue", size: 80, color: "#FFD700", x: "50%", y: "20%", align: center, stroke: "#3E1C00", stroke_width: 4, animate: fadeIn(0.6s)
+[0s .. 2.5s] = text product_name, font: "Bebas Neue", size: 80, color: "#FFD700", x: "50%", y: "20%", align: center, stroke: "#3E1C00", stroke_width: 4, animate: motion.fadeIn(0.6s)
 
-[2s .. 4.5s] = text hook_text, font: "Outfit", size: 52, color: "#FFFFFF", x: "50%", y: "45%", align: center, stroke: "#3E1C00", stroke_width: 3, animate: riseIn(0.8s)
+[2s .. 4.5s] = text hook_text, font: "Outfit", size: 52, color: "#FFFFFF", x: "50%", y: "45%", align: center, stroke: "#3E1C00", stroke_width: 3, animate: motion.riseIn(0.8s)
 
 [-] = video xai.imagine(
     "Premium lifestyle product shot of " + product_name + " chocolate milk in 250ml carton, cinematic lighting, 9:16 vertical",
@@ -19,7 +20,7 @@ input cta_text = "{{cta_text | visit your nearest grocery store}}"
     duration: 6
 )
 
-[8s .. 11s] = text cta_text, font: "Bebas Neue", size: 48, color: "#FFD700", x: "50%", y: "80%", align: center, stroke: "#3E1C00", stroke_width: 4, animate: fadeIn(0.8s)
+[8s .. 11s] = text cta_text, font: "Bebas Neue", size: 48, color: "#FFD700", x: "50%", y: "80%", align: center, stroke: "#3E1C00", stroke_width: 4, animate: motion.fadeIn(0.8s)
 
 [0s .. 12s] = filter "vignette", intensity: 0.3
 

package/skills/codex/vidscript-strict.md

@@ -2,24 +2,30 @@
 
 Follow these rules exactly. When in doubt, copy a file from `examples/system/` (installed with `scenerok skills install`).
 
-## Rule 1: Plugin imports are mandatory
+## Rule 1: Package imports are mandatory
 
 ```vidscript
 import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+import motion from "@scenerok/basic-animations"
 ```
 
-Without this line, `xai.imagine`, `xai.tts`, and animation helpers like `fadeIn` fail validation.
+Without the owning import, calls like `xai.imagine`, `xai.tts`, `eleven.music`, and `motion.fadeIn` fail validation.
 
-**Never** call `video xai.imagine(...)` or `animate: fadeIn(...)` without the import above.
+**Never** call package functions without importing the package alias first.
 
-## Rule 2: Put plugin calls directly in time blocks
+## Rule 2: Use registered plugin surfaces
 
 ```vidscript
+import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+
 [-] = video xai.imagine("Prompt here", aspect_ratio: "9:16", duration: 5)
 [-] = audio xai.tts("Voiceover line", voice: "eve")
+[0s .. 15s] = audio eleven.music("Warm premium music bed", duration: 15, instrumental: true)
 ```
 
-**Never** assign plugins to variables: `let clip = xai.imagine(...)` is invalid.
+For ElevenLabs music, import `@elevenlabs/music` and use `eleven.music(...)`, `eleven.generateMusic(...)`, or `eleven.composeMusic(...)`.
 
 ## Rule 3: Time ranges use `..`
 
@@ -42,12 +48,22 @@ Use only straight `"` inside `xai.imagine("...")`. Do not nest quotes inside the
 ## Rule 6: Audio syntax
 
 ```vidscript
+import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+
 [-] = audio xai.tts("Spoken line", voice: "eve", speed: 1.0)
+
+# Direct music call, no trailing audio params.
+[0s .. 15s] = audio eleven.music("Soft premium ad music", duration: 15, instrumental: true)
+
+# Use a binding when you need volume or fades.
+let bed = eleven.music("Soft premium ad music", duration: 15, instrumental: true)
+[0s .. 15s] = audio bed, volume: 0.35, fade_out: 2s
 ```
 
-**Invalid:** `audio music("...", duration: 15), volume: 0.35` — trailing `, volume` after a plugin call is a parse error.
+**Invalid:** `audio eleven.music("...", duration: 15), volume: 0.35` — trailing `, volume` after a direct plugin call is a parse error.
 
-Music/generative audio plugins require their own `import` when available; do not invent bare `music(...)` calls.
+**Invalid:** `eleven.generateMusic(...)` without `import eleven from "@elevenlabs/music"`.
 
 ## Rule 7: Filters
 
@@ -69,7 +85,9 @@ Do **not** use legacy `config { }` blocks — they are not part of VidScript v2.
 ## Animations (after import)
 
 ```vidscript
-[0s .. 2s] = text "Launch", x: "50%", y: "50%", animate: popIn(0.7s)
+import motion from "@scenerok/basic-animations"
+
+[0s .. 2s] = text "Launch", x: "50%", y: "50%", animate: motion.popIn(0.7s)
 ```
 
 Available: `fadeIn`, `fadeOut`, `slideX`, `slideY`, `popIn`, `riseIn`, `swingIn`, `glitchIn`, `float`, `typewriter`.

package/skills/cursor/SKILL.md

@@ -67,37 +67,32 @@ Built-in filters: `monochrome`, `sepia`, `blur`, `chromatic`, `glitch`, `vignett
 output to "video.mp4", resolution: "1080x1920", fps: 30
 ```
 
-### Module System
+### Package Imports
 
 ```vidscript
-export const BRAND_COLOR = "#FF5733"
-export timeline intro(clip: string, headline: string) {
-  [-] = clip                                # auto-append
-  clip.Trim(start: 0s, end: 3s)
-  [- 2s] = text headline, style: title      # auto-start, 2s duration
-}
+import xai from "@scenerok/xai"                    # xAI image/video/tts
+import eleven from "@elevenlabs/music"          # ElevenLabs generative music
+import motion from "@scenerok/basic-animations" # text/video animation helpers
 ```
 
-```vidscript
-import { intro } from "./timelines.vid"
-import * as pack from "./effects.vid"
-import eleven from "@elevenlabs/tts"  # future scoped package      # from npm registry
-import music from "@elevenlabs/music" # generative music
-use intro at [-] with { clip: main, headline: "Welcome" }
-```
-
-### Plugin Calls (required import)
+### Plugin Calls
 
 ```vidscript
 import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+import motion from "@scenerok/basic-animations"
 
 [-] = video xai.imagine("Cinematic product shot", aspect_ratio: "9:16", duration: 5)
 [-] = audio xai.tts("Welcome to SceneRok", voice: "eve")
+
+# ElevenLabs music package functions require an import alias.
+let bed = eleven.music("Warm premium launch bed", duration: 15, instrumental: true)
+[0s .. 15s] = audio bed, volume: 0.35, fade_out: 2s
 ```
 
-**Always** add `import xai from "@scenerok/xai"` before any `xai.imagine` / `xai.tts` call or `animate: fadeIn(...)` helper. Calls without import fail validation with `Unknown function 'xai.imagine'`.
+**Always** import the package that owns the function: `xai.*` from `@scenerok/xai`, `eleven.*` from `@elevenlabs/music`, and `motion.*` from `@scenerok/basic-animations`. Calls without import fail validation with `Unknown function 'xai.imagine'`.
 
-Put plugin calls **directly** in time blocks — never `let clip = xai.imagine(...)`.
+For ElevenLabs music, import `@elevenlabs/music` and call `eleven.music(...)`, `eleven.generateMusic(...)`, or `eleven.composeMusic(...)`. Use `let bed = eleven.music(...)` followed by `audio bed, volume: ...` when you need volume or fades.
 
 Read `vidscript-strict.md` for anti-patterns and `examples/system/*.vid` for copy-paste templates (installed with `scenerok skills install`).
 

package/skills/cursor/vidscript-guide.md

@@ -4,18 +4,20 @@ VidScript is a declarative DSL for composing short-form videos. Write a script,
 
 ## Agent quick start (read before composing)
 
-1. **Import plugins** — `import xai from "@scenerok/xai"` before `xai.imagine`, `xai.tts`, or `animate: fadeIn(...)`.
+1. **Import every package function** — use `import xai from "@scenerok/xai"`, `import eleven from "@elevenlabs/music"`, and `import motion from "@scenerok/basic-animations"` before calling `xai.*`, `eleven.*`, or `motion.*`.
 2. **Validate early** — `scenerok validate file.vid` (errors show as `Line N:C — message`).
-3. **Copy working examples** — see `examples/system/` in this skill folder (e.g. `minimal-text-reel.vid`, `ecom-product-launch.vid`, `rokmilk-chocolate-promo.vid`).
-4. **Strict rules** — see `vidscript-strict.md` for invalid patterns (bare `xai.imagine`, `audio music(...), volume:`, nested quotes in prompts).
+3. **Music package syntax** — `import eleven from "@elevenlabs/music"`, then call `eleven.music(...)`, `eleven.generateMusic(...)`, or `eleven.composeMusic(...)`.
+4. **Copy working examples** — see `examples/system/` in this skill folder (e.g. `minimal-text-reel.vid`, `ecom-product-launch.vid`, `rokmilk-chocolate-promo.vid`).
+5. **Strict rules** — see `vidscript-strict.md` for invalid patterns (bare `xai.imagine`, bare `eleven.music(...)` without import, trailing params after direct plugin calls, nested quotes in prompts).
 
 ### Common validation failures
 
 | Symptom | Fix |
 |---------|-----|
 | `Unknown function 'xai.imagine'` | Add `import xai from "@scenerok/xai"` at top |
-| `Unknown function 'fadeIn'` | Same import (animation helpers are plugin-backed) |
-| `Expected ... but "," found` | Do not put `, volume:` after a plugin call on the same line |
+| `Unknown function 'fadeIn'` | Use `import motion from "@scenerok/basic-animations"` and call `motion.fadeIn(...)` |
+| `Expected ... but "," found` | Do not put `, volume:` after a direct plugin call. Use `let bed = eleven.music(...)`, then `audio bed, volume: ...` |
+| `Unknown function 'eleven.generateMusic'` | Add `import eleven from "@elevenlabs/music"` before calling `eleven.generateMusic(...)` |
 | Parse error on imagine prompt | Remove nested `"` quotes inside the prompt string |
 
 ## Program Structure
@@ -66,28 +68,18 @@ let clipName = "hero"
 
 Variables can hold strings, numbers, time literals, and object expressions. Variables are evaluated at compile time.
 
-### Import / Export (Module System)
+### Package Imports
 
-```vidscript
-# Export a constant
-export const BRAND_COLOR = "#FF5733"
-
-# Export a timeline
-export timeline intro(clip: string, title_text: string) {
-  [-] = clip
-  [- 2s] = text title_text, size: 72
-}
+Only default package imports are supported for callable packages. Call functions through the imported alias.
 
-# Import from another file
-import { intro, BRAND_COLOR } from "./timelines.vid"
-
-# Import namespace
-import * as transitions from "@scenerok/transitions"
-
-# Use a timeline
-use intro at 0s .. 5s with { clip: hero, title_text: "Hello" }
+```vidscript
+import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+import motion from "@scenerok/basic-animations"
 ```
 
+Named imports (`import { fn } ...`) and namespace imports (`import * as ...`) are not supported.
+
 ## Time Blocks
 
 Time blocks are the core of VidScript. They define when instructions execute on the timeline.
@@ -238,19 +230,28 @@ Audio sources can be MP3 inputs, audio plugin results, or the embedded audio str
 
 ```vidscript
 import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+import motion from "@scenerok/basic-animations"
 
 [-] = video xai.imagine("Cinematic product shot", aspect_ratio: "9:16", duration: 5)
 [-] = audio xai.tts("Welcome to SceneRok", voice: "eve")
+
+# ElevenLabs music package functions require an import alias.
+[0s .. 15s] = audio eleven.music("Warm premium launch bed", duration: 15, instrumental: true)
+
+# If you need volume or fades, store the generated audio first.
+let bed = eleven.music("Warm premium launch bed", duration: 15, instrumental: true)
+[0s .. 15s] = audio bed, volume: 0.35, fade_out: 2s
 ```
 
-Plugins require an explicit default import. The server registers `@scenerok/xai` when API keys are configured. Plugin calls run at compile time and must appear **inside time blocks**, not in `let` assignments.
+`@scenerok/xai` requires an explicit default import. ElevenLabs music validates as `eleven.music(...)`, `eleven.generateMusic(...)`, or `eleven.composeMusic(...)` after `import eleven from "@elevenlabs/music"`. Plugin calls run at compile time; direct media plugin instructions cannot have trailing audio params, so use a `let` binding when you need `volume`, `fade_in`, or `fade_out`.
 
 **Invalid (will not validate):**
 
 ```vidscript
-[-] = video xai.imagine("...")          # missing import
-[-] = audio music("..."), volume: 0.5   # trailing params after plugin call
-let clip = xai.imagine("...")           # plugin assigned to variable
+[-] = video xai.imagine("...")                    # missing xAI import
+[0s .. 15s] = audio eleven.generateMusic("...")   # missing `import eleven from "@elevenlabs/music"`
+[0s .. 15s] = audio eleven.music("..."), volume: 0.5      # trailing params after direct plugin call
 ```
 
 ## Animations, Effects & Plugins (v2 Extensibility)
@@ -269,9 +270,11 @@ These accept either plugin function calls or plain object descriptors.
 Attach animations to **any** text or video surface.
 
 ```vidscript
-text "Hello", animate: fadeIn(0.8s)
+import motion from "@scenerok/basic-animations"
+
+text "Hello", animate: motion.fadeIn(0.8s)
 
-video hero, animate: [fadeIn(0.5s), slideY(-40, 0, 1.2s)]
+video hero, animate: [motion.fadeIn(0.5s), motion.slideY(-40, 0, 1.2s)]
 
 text "Title", animate: {
   type: "fade",
@@ -299,16 +302,16 @@ video hero, effects: [{
 
 | Function                  | Description                  |
 |---------------------------|------------------------------|
-| `fadeIn(duration?)`       | Opacity 0 → 1                |
-| `fadeOut(duration?)`      | Opacity 1 → 0                |
-| `slideX(from, to, dur?)`  | Horizontal slide             |
-| `slideY(from, to, dur?)`  | Vertical slide               |
-| `popIn(duration?)`        | Scale + fade entrance        |
-| `riseIn(duration?, dist?)` | Upward fade entrance         |
-| `swingIn(duration?)`      | Rotating slide/fade         |
-| `glitchIn(duration?)`     | Jitter + flash entrance      |
-| `float(duration?, amp?)`   | Gentle vertical bob          |
-| `typewriter(duration?)`   | Character reveal             |
+| `motion.fadeIn(duration?)`       | Opacity 0 → 1                |
+| `motion.fadeOut(duration?)`      | Opacity 1 → 0                |
+| `motion.slideX(from, to, dur?)`  | Horizontal slide             |
+| `motion.slideY(from, to, dur?)`  | Vertical slide               |
+| `motion.popIn(duration?)`        | Scale + fade entrance        |
+| `motion.riseIn(duration?, dist?)` | Upward fade entrance         |
+| `motion.swingIn(duration?)`      | Rotating slide/fade         |
+| `motion.glitchIn(duration?)`     | Jitter + flash entrance      |
+| `motion.float(duration?, amp?)`   | Gentle vertical bob          |
+| `motion.typewriter(duration?)`   | Character reveal             |
 
 More plugins (advanced text animations, pixel effects, 3D, etc.) are planned.
 

package/skills/cursor/vidscript-sample.md

@@ -4,14 +4,15 @@ Copy this shape for promos that use xAI-generated clips. Run `scenerok validate`
 
 ```vidscript
 import xai from "@scenerok/xai"
+import motion from "@scenerok/basic-animations"
 
 input product_name = "{{product_name | RokMilk}}"
 input hook_text = "{{hook_text | Chocolate Milkshake}}"
 input cta_text = "{{cta_text | visit your nearest grocery store}}"
 
-[0s .. 2.5s] = text product_name, font: "Bebas Neue", size: 80, color: "#FFD700", x: "50%", y: "20%", align: center, stroke: "#3E1C00", stroke_width: 4, animate: fadeIn(0.6s)
+[0s .. 2.5s] = text product_name, font: "Bebas Neue", size: 80, color: "#FFD700", x: "50%", y: "20%", align: center, stroke: "#3E1C00", stroke_width: 4, animate: motion.fadeIn(0.6s)
 
-[2s .. 4.5s] = text hook_text, font: "Outfit", size: 52, color: "#FFFFFF", x: "50%", y: "45%", align: center, stroke: "#3E1C00", stroke_width: 3, animate: riseIn(0.8s)
+[2s .. 4.5s] = text hook_text, font: "Outfit", size: 52, color: "#FFFFFF", x: "50%", y: "45%", align: center, stroke: "#3E1C00", stroke_width: 3, animate: motion.riseIn(0.8s)
 
 [-] = video xai.imagine(
     "Premium lifestyle product shot of " + product_name + " chocolate milk in 250ml carton, cinematic lighting, 9:16 vertical",
@@ -19,7 +20,7 @@ input cta_text = "{{cta_text | visit your nearest grocery store}}"
     duration: 6
 )
 
-[8s .. 11s] = text cta_text, font: "Bebas Neue", size: 48, color: "#FFD700", x: "50%", y: "80%", align: center, stroke: "#3E1C00", stroke_width: 4, animate: fadeIn(0.8s)
+[8s .. 11s] = text cta_text, font: "Bebas Neue", size: 48, color: "#FFD700", x: "50%", y: "80%", align: center, stroke: "#3E1C00", stroke_width: 4, animate: motion.fadeIn(0.8s)
 
 [0s .. 12s] = filter "vignette", intensity: 0.3
 

package/skills/cursor/vidscript-strict.md

@@ -2,24 +2,30 @@
 
 Follow these rules exactly. When in doubt, copy a file from `examples/system/` (installed with `scenerok skills install`).
 
-## Rule 1: Plugin imports are mandatory
+## Rule 1: Package imports are mandatory
 
 ```vidscript
 import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+import motion from "@scenerok/basic-animations"
 ```
 
-Without this line, `xai.imagine`, `xai.tts`, and animation helpers like `fadeIn` fail validation.
+Without the owning import, calls like `xai.imagine`, `xai.tts`, `eleven.music`, and `motion.fadeIn` fail validation.
 
-**Never** call `video xai.imagine(...)` or `animate: fadeIn(...)` without the import above.
+**Never** call package functions without importing the package alias first.
 
-## Rule 2: Put plugin calls directly in time blocks
+## Rule 2: Use registered plugin surfaces
 
 ```vidscript
+import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+
 [-] = video xai.imagine("Prompt here", aspect_ratio: "9:16", duration: 5)
 [-] = audio xai.tts("Voiceover line", voice: "eve")
+[0s .. 15s] = audio eleven.music("Warm premium music bed", duration: 15, instrumental: true)
 ```
 
-**Never** assign plugins to variables: `let clip = xai.imagine(...)` is invalid.
+For ElevenLabs music, import `@elevenlabs/music` and use `eleven.music(...)`, `eleven.generateMusic(...)`, or `eleven.composeMusic(...)`.
 
 ## Rule 3: Time ranges use `..`
 
@@ -42,12 +48,22 @@ Use only straight `"` inside `xai.imagine("...")`. Do not nest quotes inside the
 ## Rule 6: Audio syntax
 
 ```vidscript
+import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+
 [-] = audio xai.tts("Spoken line", voice: "eve", speed: 1.0)
+
+# Direct music call, no trailing audio params.
+[0s .. 15s] = audio eleven.music("Soft premium ad music", duration: 15, instrumental: true)
+
+# Use a binding when you need volume or fades.
+let bed = eleven.music("Soft premium ad music", duration: 15, instrumental: true)
+[0s .. 15s] = audio bed, volume: 0.35, fade_out: 2s
 ```
 
-**Invalid:** `audio music("...", duration: 15), volume: 0.35` — trailing `, volume` after a plugin call is a parse error.
+**Invalid:** `audio eleven.music("...", duration: 15), volume: 0.35` — trailing `, volume` after a direct plugin call is a parse error.
 
-Music/generative audio plugins require their own `import` when available; do not invent bare `music(...)` calls.
+**Invalid:** `eleven.generateMusic(...)` without `import eleven from "@elevenlabs/music"`.
 
 ## Rule 7: Filters
 
@@ -69,7 +85,9 @@ Do **not** use legacy `config { }` blocks — they are not part of VidScript v2.
 ## Animations (after import)
 
 ```vidscript
-[0s .. 2s] = text "Launch", x: "50%", y: "50%", animate: popIn(0.7s)
+import motion from "@scenerok/basic-animations"
+
+[0s .. 2s] = text "Launch", x: "50%", y: "50%", animate: motion.popIn(0.7s)
 ```
 
 Available: `fadeIn`, `fadeOut`, `slideX`, `slideY`, `popIn`, `riseIn`, `swingIn`, `glitchIn`, `float`, `typewriter`.

package/skills/opencode/SKILL.md

@@ -67,37 +67,32 @@ Built-in filters: `monochrome`, `sepia`, `blur`, `chromatic`, `glitch`, `vignett
 output to "video.mp4", resolution: "1080x1920", fps: 30
 ```
 
-### Module System
+### Package Imports
 
 ```vidscript
-export const BRAND_COLOR = "#FF5733"
-export timeline intro(clip: string, headline: string) {
-  [-] = clip                                # auto-append
-  clip.Trim(start: 0s, end: 3s)
-  [- 2s] = text headline, style: title      # auto-start, 2s duration
-}
+import xai from "@scenerok/xai"                    # xAI image/video/tts
+import eleven from "@elevenlabs/music"          # ElevenLabs generative music
+import motion from "@scenerok/basic-animations" # text/video animation helpers
 ```
 
-```vidscript
-import { intro } from "./timelines.vid"
-import * as pack from "./effects.vid"
-import eleven from "@elevenlabs/tts"  # future scoped package      # from npm registry
-import music from "@elevenlabs/music" # generative music
-use intro at [-] with { clip: main, headline: "Welcome" }
-```
-
-### Plugin Calls (required import)
+### Plugin Calls
 
 ```vidscript
 import xai from "@scenerok/xai"
+import eleven from "@elevenlabs/music"
+import motion from "@scenerok/basic-animations"
 
 [-] = video xai.imagine("Cinematic product shot", aspect_ratio: "9:16", duration: 5)
 [-] = audio xai.tts("Welcome to SceneRok", voice: "eve")
+
+# ElevenLabs music package functions require an import alias.
+let bed = eleven.music("Warm premium launch bed", duration: 15, instrumental: true)
+[0s .. 15s] = audio bed, volume: 0.35, fade_out: 2s
 ```
 
-**Always** add `import xai from "@scenerok/xai"` before any `xai.imagine` / `xai.tts` call or `animate: fadeIn(...)` helper. Calls without import fail validation with `Unknown function 'xai.imagine'`.
+**Always** import the package that owns the function: `xai.*` from `@scenerok/xai`, `eleven.*` from `@elevenlabs/music`, and `motion.*` from `@scenerok/basic-animations`. Calls without import fail validation with `Unknown function 'xai.imagine'`.
 
-Put plugin calls **directly** in time blocks — never `let clip = xai.imagine(...)`.
+For ElevenLabs music, import `@elevenlabs/music` and call `eleven.music(...)`, `eleven.generateMusic(...)`, or `eleven.composeMusic(...)`. Use `let bed = eleven.music(...)` followed by `audio bed, volume: ...` when you need volume or fades.
 
 Read `vidscript-strict.md` for anti-patterns and `examples/system/*.vid` for copy-paste templates (installed with `scenerok skills install`).