@vanillaskyai/video 0.10.23 → 0.11.0

package/dist/{compose-video-BH5K6XWT.js → compose-video-H2YUQDUY.js}

@@ -1,12 +1,12 @@
 import {
   createVideo
-} from "./chunk-5BSJLT6H.js";
+} from "./chunk-E7FHBLAC.js";
+import "./chunk-Z3DLSLAJ.js";
+import "./chunk-WZESNEPT.js";
 import "./chunk-E7CL7UPB.js";
-import "./chunk-RXTN2CW6.js";
-import "./chunk-7M56IUUX.js";
+import "./chunk-6Z3ID54H.js";
 import "./chunk-AUPC6MDK.js";
 import "./chunk-7NZOMTAL.js";
-import "./chunk-3O7OMMMF.js";
 export {
   createVideo
 };

package/dist/{events-B4YCc4vc.d.ts → events-BZAfl0Dm.d.ts}

@@ -1,4 +1,4 @@
-import { b as VideoOrientation, V as VideoStyle, c as Video, a as VideoCapabilities, d as VideoAudio, e as VideoScene, f as VIDEO_PROTOCOL_VERSION } from './types-DdZw4GRQ.js';
+import { V as VideoOrientation, a as VideoStyle, b as Video, c as VideoCapabilities, d as VideoAudio, e as VideoScene, f as VIDEO_PROTOCOL_VERSION } from './types-ht-Zw3Wv.js';
 
 type VideoWarningCategory = "validation" | "readability" | "grounding" | "provider" | "media" | "protocol";
 type VideoWarningCode = "scene_duration_adjusted" | "scene_omitted_unreadable" | "scene_omitted_for_closer" | "scene_variable_clipped" | "chart_scale_imbalance" | "plan_incomplete" | "plan_missing_closer" | "provider_warning" | "provider_diagnostics_unavailable" | "media_budget_reached";

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { c as Video, e as VideoScene, g as VideoTemplatePacing } from './types-DdZw4GRQ.js';
-export { d as VideoAudio, h as VideoNarrationGroup, b as VideoOrientation, V as VideoStyle, i as VideoStyleOptions } from './types-DdZw4GRQ.js';
+import { b as Video, e as VideoScene, g as VideoTemplatePacing } from './types-ht-Zw3Wv.js';
+export { d as VideoAudio, h as VideoNarrationGroup, V as VideoOrientation, a as VideoStyle, i as VideoStyleOptions } from './types-ht-Zw3Wv.js';
 
 type VideoStatus = "idle" | "streaming" | "complete" | "error" | "aborted";
 

package/dist/index.js

@@ -1,17 +1,15 @@
 import {
   getSceneDuration,
   getSceneDurationBounds,
-  getSpokenDuration
-} from "./chunk-ZD2VTUYR.js";
+  getSpokenDuration,
+  getVideoDuration
+} from "./chunk-KMVRBUL5.js";
+import "./chunk-WZESNEPT.js";
 import {
   VideoValidationError,
   parseVideo
 } from "./chunk-AUPC6MDK.js";
 import "./chunk-7NZOMTAL.js";
-import "./chunk-3O7OMMMF.js";
-import {
-  getVideoDuration
-} from "./chunk-SPVTJH3F.js";
 export {
   VideoValidationError,
   getSceneDuration,

package/dist/preload-media-23JXUFCF.js

@@ -0,0 +1,77 @@
+import {
+  resolveMediaType
+} from "./chunk-K5J7ESRO.js";
+import {
+  withDeadline
+} from "./chunk-4G4JBMCM.js";
+
+// src/player/preload-media.ts
+var MAX_QUEUED_URLS = 64;
+var MAX_REMEMBERED_URLS = 64;
+var MAX_WARM_BYTES = 32 * 1024 * 1024;
+var warmed = /* @__PURE__ */ new Set();
+var pending = /* @__PURE__ */ new Map();
+var queue = [];
+var running = false;
+function pump() {
+  if (running) return;
+  const job = queue.shift();
+  if (!job) return;
+  if (job.signal?.aborted) {
+    pending.delete(job.url);
+    job.done();
+    pump();
+    return;
+  }
+  running = true;
+  void withDeadline(async (signal) => {
+    const response = await fetch(job.url, { signal, cache: "force-cache" });
+    if (!response.ok) throw new Error("Media warm failed");
+    const reader = response.body?.getReader();
+    if (reader) {
+      let bytes = 0;
+      try {
+        while (true) {
+          const part = await reader.read();
+          if (part.done) break;
+          bytes += part.value.byteLength;
+          if (bytes > MAX_WARM_BYTES) throw new Error("Media warm exceeded its byte allowance");
+        }
+      } finally {
+        await reader.cancel().catch(() => void 0);
+        reader.releaseLock();
+      }
+    }
+    warmed.add(job.url);
+    while (warmed.size > MAX_REMEMBERED_URLS) warmed.delete(warmed.values().next().value);
+  }, 8e3, job.signal).catch(() => void 0).finally(() => {
+    running = false;
+    pending.delete(job.url);
+    job.done();
+    pump();
+  });
+}
+function warm(url, signal) {
+  if (!url || signal?.aborted || warmed.has(url)) return Promise.resolve();
+  const existing = pending.get(url);
+  if (existing) return existing;
+  if (queue.length >= MAX_QUEUED_URLS) return Promise.resolve();
+  let done;
+  const result = new Promise((resolve) => {
+    done = resolve;
+  });
+  pending.set(url, result);
+  queue.push({ url, signal, done });
+  pump();
+  return result;
+}
+async function preloadSceneMedia(variables, signal) {
+  if (typeof window === "undefined" || typeof fetch === "undefined") return;
+  const url = typeof variables.mediaUrl === "string" ? variables.mediaUrl.trim() : "";
+  if (!url || resolveMediaType(String(variables.mediaType || "auto"), url) === "gradient") return;
+  const poster = typeof variables.mediaPoster === "string" ? variables.mediaPoster.trim() : "";
+  await Promise.all([warm(poster, signal), warm(url, signal)]);
+}
+export {
+  preloadSceneMedia
+};

package/dist/react.d.ts

@@ -1,10 +1,8 @@
 import * as react from 'react';
 import { CSSProperties, ReactElement, ReactNode } from 'react';
-import { b as VideoEvent } from './events-B4YCc4vc.js';
-import { b as VideoOrientation, e as VideoScene, c as Video, i as VideoStyleOptions } from './types-DdZw4GRQ.js';
-import { T as TemplateRegistry } from './kit-DrRpdn0p.js';
-import { V as VideoChatMode, a as VideoChatAskOptions, b as VideoChatMedia, c as VideoChatSuggestion, d as VideoChatCapabilities, e as VideoChatWelcome } from './types-BqB8zC9u.js';
-import './catalog-types-WTbLP6Jh.js';
+import { b as VideoEvent } from './events-BZAfl0Dm.js';
+import { V as VideoOrientation, e as VideoScene, b as Video, i as VideoStyleOptions } from './types-ht-Zw3Wv.js';
+import { a as VideoChatMode, e as VideoChatAskOptions, f as VideoChatMedia, g as VideoChatSuggestion, c as VideoChatCapabilities, h as VideoChatWelcome } from './types-CG-kPI81.js';
 
 type VideoPlaybackMode = "manual" | "muted-autoplay" | "autoplay-with-sound" | "autoplay-after-interaction";
 
@@ -12,6 +10,16 @@ interface NativeMediaAudioOptions {
     /** Volume of the active scene video's embedded audio, from 0 to 1. */
     volume?: number;
 }
+type PlaybackWaitReason = "scene-generation" | "speech" | "media-decoding";
+type MediaPlaybackMetric = {
+    type: "media-playback";
+    clipDurationSec: number;
+    sceneDurationSec: number;
+    repeatCount: number;
+} | {
+    type: "buffer";
+    bufferedSeconds: number;
+};
 interface VideoPlayerSharedProps {
     /** High-level startup policy. When set, this overrides autoPlay and startMuted. */
     playbackMode?: VideoPlaybackMode;
@@ -44,6 +52,8 @@ interface VideoPlayerSharedProps {
     narrationReady?: () => boolean;
     /** Active audio time: paragraph-relative for a narration group, scene-relative otherwise. Undefined resumes the normal clock. */
     narrationTime?: (scene: VideoScene) => number | undefined;
+    /** Actual utterance completion when a voice has no audio clock. Pair with useNarration.isSpeaking. */
+    narrationActive?: (scene: VideoScene) => boolean;
     /**
      * Hold the playhead where it is, and release it again.
      *
@@ -70,21 +80,21 @@ interface VideoPlayerSharedProps {
     /** First actual mounted video frame; excludes graphics, posters and safe fallbacks. */
     onMediaFramePresented?: () => unknown;
     /** Stream playback has reached its available scenes; excludes initial waiting and deliberate pauses. */
-    onStallChange?: (stalled: boolean) => unknown;
+    onStallChange?: (stalled: boolean, reason?: PlaybackWaitReason) => unknown;
+    /** Opt-in local native-media diagnostics; contains no scene IDs, URLs, or content. */
+    onPlaybackMetric?: (metric: MediaPlaybackMetric) => unknown;
     /** Fires when the scene under the playhead changes, including on a loop wrap. */
     onSceneChange?: (scene: VideoScene, index: number) => void;
 }
 type VideoPlayerProps = VideoPlayerSharedProps & ({
     video: Video;
     stream?: never;
-    templates?: TemplateRegistry;
 } | {
     stream?: AsyncIterable<VideoEvent>;
     video?: never;
-    templates?: TemplateRegistry;
 });
 
-declare function VideoPlayer({ templates, stream, video, onPlaybackEnd, onComplete, onError, ...props }: VideoPlayerProps): ReactElement | null;
+declare function VideoPlayer({ stream, video, onPlaybackEnd, onComplete, onError, ...props }: VideoPlayerProps): ReactElement | null;
 
 interface VideoErrorOptions {
     code: string;
@@ -193,8 +203,6 @@ interface VideoChatTurn {
 interface UseVideoChatOptions {
     /** One provider-neutral route created with createVideoChatHandler. */
     endpoint?: string | URL;
-    /** Customer-owned templates that replace built-ins and add new renderers. */
-    templates?: TemplateRegistry;
     mode?: VideoChatMode;
     orientation?: VideoOrientation;
     style?: VideoStyleOptions;
@@ -225,8 +233,13 @@ type VideoChatPlaybackMetric = {
 } | {
     type: "stall";
     durationMs: number;
-    reason: "scene-generation";
-});
+    reason: PlaybackWaitReason;
+} | {
+    type: "scene-duration";
+    speechDurationSec: number;
+    clipDurationSec: number;
+    recovered: boolean;
+} | MediaPlaybackMetric);
 interface VideoChatFirstFrameMetric {
     turnId: string;
     mode: VideoChatMode;
@@ -266,16 +279,27 @@ interface UseVideoChatResult {
 declare function useVideoChat(options?: UseVideoChatOptions): UseVideoChatResult;
 
 interface VideoChatProps {
-    /** Connection, providers, templates, and rendering defaults for the session. */
+    /** Connection, voice, and rendering defaults for the session. */
     options?: UseVideoChatOptions;
     /** Added to the scoped component root for application layout and branding. */
     className?: string;
     /** Replaces the default two-line welcome heading without changing the interaction. */
     welcomeTitle?: ReactNode;
+    /** Application identity only; does not change scenes, prompts or playback. */
+    branding?: {
+        /** Visible fallback when logo is omitted, and the home link's accessible name. */
+        name: string;
+        /** App-owned logo element. Give images/SVGs explicit dimensions. */
+        logo?: ReactNode;
+        /** HTTP(S) or root-relative destination. Omit to preserve the Home/reset shortcut. */
+        homeUrl?: string;
+        /** Keep the SDK's Docs/About/GitHub section in Settings. Defaults to true. */
+        showDeveloperLinks?: boolean;
+    };
     /** Show a dismissible safe notice when generated visuals fall back. Defaults to false. */
     showRecoveryNotice?: boolean;
 }
 /** A complete voice-and-video chat interface backed by createVideoChatHandler. */
-declare function VideoChat({ options, className, welcomeTitle, showRecoveryNotice }: VideoChatProps): react.JSX.Element;
+declare function VideoChat({ options, className, welcomeTitle, branding, showRecoveryNotice }: VideoChatProps): react.JSX.Element;
 
 export { type CreateVideoChatVoiceOptions, type UseVideoChatOptions, type UseVideoChatResult, VideoChat, VideoChatAskOptions, VideoChatCapabilities, type VideoChatFirstFrameMetric, VideoChatMedia, VideoChatMode, type VideoChatPlaybackMetric, type VideoChatPreparedSpeech, type VideoChatProps, type VideoChatStatus, VideoChatSuggestion, type VideoChatTurn, type VideoChatVoice, VideoChatWelcome, VideoError, type VideoErrorOptions, type VideoPlaybackMode, VideoPlayer, type VideoPlayerProps, createVideoChatVoice, useVideoChat };