@scenerok/sdk 0.7.0 → 0.9.0

package/skills/scenerok/references/tts.md

@@ -0,0 +1,64 @@
+# Text-to-Speech
+
+`import xai from "@scenerok/xai"` — voiceover via `audio xai.tts(...)`.
+
+Voice IDs: `eve` (upbeat), `ara` (warm), `rex` (business), `sal` (balanced), `leo` (authoritative).
+```vidscript
+import xai from "@scenerok/xai"
+let vo = xai.tts("Welcome to SceneRok", voice: "eve")
+[0 .. vo.duration] = audio vo
+```
+
+**Never guess a TTS window.** You cannot know the audio length while writing the script. Either assign with `let` and use `vo.duration` in time expressions (measured from the generated file), or use `[-] = audio xai.tts(...)` blocks, which auto-size and never overlap each other. 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
+import xai from "@scenerok/xai"
+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
+
+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")
+```
+