@vanillaskyai/video 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -4,6 +4,12 @@ VanillaSky follows semantic versioning. This changelog begins with the 0.1 beta.
 
 ## Unreleased
 
+## 0.4.1
+
+- Keeps soundtrack audio continuous when a saved `VideoPlayer` uses `loop`.
+  A track shorter than the visual timeline now repeats as soon as it ends,
+  instead of leaving silence until the video itself wraps.
+
 ## 0.4.0
 
 - Adds `loop` to `VideoPlayer` for saved videos. A completed video previously

package/README.md

@@ -1,6 +1,6 @@
 # Give your AI a video output
 
-![Version 0.4.0 beta](https://img.shields.io/badge/version-0.4.0_beta-7c3aed)
+![Version 0.4.1 beta](https://img.shields.io/badge/version-0.4.1_beta-7c3aed)
 
 **VanillaSky is the open-source video response layer.** Turn text, structured
 data, and live application context into personalized video responses that start
@@ -17,7 +17,7 @@ the planning prompt, trusted templates, validation, streaming, and player.
 For humans:
 
 ```bash
-npm install @vanillaskyai/video@0.4.0 ai @ai-sdk/openai
+npm install @vanillaskyai/video@0.4.1 ai @ai-sdk/openai
 ```
 
 For coding agents:
@@ -106,7 +106,7 @@ shows each complete, validated scene as soon as it is ready and returns a
 deterministic `Video` object when generation finishes.
 
 A copy-and-run app is in
-[`examples/nextjs-quickstart`](https://github.com/VanillaSkyAi/video/tree/v0.4.0/examples/nextjs-quickstart).
+[`examples/nextjs-quickstart`](https://github.com/VanillaSkyAi/video/tree/v0.4.1/examples/nextjs-quickstart).
 
 ## Shape the response
 

package/dist/react.d.ts

@@ -22,7 +22,7 @@ interface VideoPlayerSharedProps {
     style?: CSSProperties;
     /** Accessible name for the player region. */
     ariaLabel?: string;
-    /** Restart from the beginning instead of showing the replay affordance. Saved videos only. */
+    /** Repeat the saved video and its soundtrack instead of showing the replay affordance. */
     loop?: boolean;
     onComplete?: (video: Video) => void;
     onError?: (error: Error) => void;

package/dist/react.js

@@ -733,7 +733,7 @@ function VideoPlayerRuntime({
             autoPlay: isPlaying,
             muted: isMuted,
             preload: "auto",
-            loop: state.status === "streaming" || introPlaying
+            loop: loop || state.status === "streaming" || introPlaying
           },
           config.audio.audioUrl
         ) : null,

package/docs/getting-started.md

@@ -5,7 +5,7 @@
 Install VanillaSky:
 
 ```bash
-npm install @vanillaskyai/video@0.4.0 ai @ai-sdk/openai
+npm install @vanillaskyai/video@0.4.1 ai @ai-sdk/openai
 ```
 
 Set your provider key in `.env.local` (never commit it):
@@ -50,7 +50,7 @@ sets its marker only for `next dev`, and it accepts only localhost. Every
 production request is denied. Replace it with your real session validation
 before deploying. For literal files and commands,
 use the tested
-[`examples/nextjs-quickstart` directory](https://github.com/VanillaSkyAi/video/tree/v0.4.0/examples/nextjs-quickstart).
+[`examples/nextjs-quickstart` directory](https://github.com/VanillaSkyAi/video/tree/v0.4.1/examples/nextjs-quickstart).
 
 `model` can come from any AI SDK provider, registry, gateway, compatible API,
 or custom implementation. The application can choose a cheaper or faster model

package/docs/integrate-nextjs.md

@@ -5,7 +5,7 @@
 Install VanillaSky and one AI SDK provider:
 
 ```bash
-npm install @vanillaskyai/video@0.4.0 ai @ai-sdk/openai
+npm install @vanillaskyai/video@0.4.1 ai @ai-sdk/openai
 ```
 
 Create an ignored `.env.local`:
@@ -74,7 +74,7 @@ requests; replace it with your application's session validation before
 deploying.
 
 The copy-and-run app is in the
-[`examples/nextjs-quickstart` directory](https://github.com/VanillaSkyAi/video/tree/v0.4.0/examples/nextjs-quickstart).
+[`examples/nextjs-quickstart` directory](https://github.com/VanillaSkyAi/video/tree/v0.4.1/examples/nextjs-quickstart).
 
 For another LLM, replace `openai(...)` with the matching AI SDK model. The route
 shape and React code stay the same. See [Provider integration](provider-integration.md)

package/docs/live-channels.md

@@ -33,7 +33,9 @@ The job owns the data and the mapping. The player owns nothing but playback.
 ## Play without stopping
 
 Pass `loop` alongside a saved video. The player restarts from the beginning
-instead of showing its replay affordance, and keeps its soundtrack in step.
+instead of showing its replay affordance and loops its soundtrack continuously.
+A track shorter than the channel repeats as soon as it ends; when the visual
+timeline wraps, the soundtrack restarts from the beginning with it.
 
 <!-- verify:live-channel-example:start -->
 ```tsx
@@ -130,7 +132,8 @@ reading time will stretch its animation instead and give them none.
 - **Never replace a good channel with a broken one.** Validate first, and on
   failure leave the previous configuration in place.
 - **Autoplay needs `playbackMode="muted-autoplay"`.** Browsers refuse unmuted
-  autoplay, and a channel has no one present to click.
+  autoplay. A channel can still carry a looping soundtrack: it starts muted and
+  becomes audible when a viewer uses the player's sound control.
 - **Host your media.** Loops re-request assets over long sessions; serving them
   from your own origin keeps a content policy simple and avoids depending on
   someone else's CDN.

package/docs/media-and-audio.md

@@ -87,6 +87,13 @@ generated scene exists, and render it with `autoPlay` and `startMuted={false}`.
 If the browser blocks the audible start, the player returns to the first frame
 and exposes its sound-start control.
 
+For a saved video rendered with `<VideoPlayer video={video} loop />`, the
+soundtrack loops too. A track shorter than the visual timeline repeats without
+a silent gap, and the player restarts it from the beginning when the visual
+timeline wraps. This does not bypass browser autoplay policy: use muted autoplay
+for unattended playback and let a viewer unmute, or start audible playback from
+a user interaction.
+
 ## Media providers
 
 VanillaSky is provider-independent. When `resolveMedia` is configured, the

package/examples/nextjs-quickstart/package.json

@@ -9,7 +9,7 @@
   },
   "dependencies": {
     "@ai-sdk/openai": "^4.0.42",
-    "@vanillaskyai/video": "0.4.0",
+    "@vanillaskyai/video": "0.4.1",
     "ai": "^7.0.66",
     "next": "16.3.1",
     "react": "19.2.8",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanillaskyai/video",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Open-source video response SDK for personalized AI applications.",
   "keywords": [
     "generative-video",