@vanillaskyai/video 0.1.1 → 0.3.0

package/dist/{chunk-IXCUY3B3.js → chunk-XYZOJ5NZ.js}

@@ -5,11 +5,11 @@ import {
   applyVideoEvent,
   checksumVideo,
   createVideoState
-} from "./chunk-ABPKM4GK.js";
+} from "./chunk-STIFILQG.js";
 import {
   parseVideoPlanPart,
   safePublicDiagnostic
-} from "./chunk-ERY4S6QV.js";
+} from "./chunk-JW47XCRL.js";
 import {
   MAX_RETAINED_INSTRUCTIONS_LENGTH,
   MAX_RETAINED_MEDIA_URLS,
@@ -26,7 +26,7 @@ import {
   getCloserReserve,
   getReadableSceneDuration,
   paceScene
-} from "./chunk-EVG2ZYIY.js";
+} from "./chunk-3O7OMMMF.js";
 import {
   resolveVideoBrand
 } from "./chunk-XGRA2MUV.js";
@@ -95,19 +95,24 @@ function resolveSuppliedMediaPlanPart(part, input) {
 function buildVideoUserPrompt(input, openingDurationSec = 0) {
   return [
     "Compose a video response from the structured customer input below.",
+    `Knowledge mode: ${input.knowledgeMode ?? "input-only"}.`,
     `Maximum duration: ${input.maxDurationSec ?? 30} seconds, including the supplied opening.`,
     input.opening?.trim() ? `The host has already added the opening scene, which consumes ${openingDurationSec} seconds. Continue after it and do not repeat or rewrite it.` : "Add the first grounded scene as soon as it is complete.",
     "The first generated body scene must be fully playable without external media. Use a content-fit text, data, comparison, list, or device-free template with no media URL or keyword.",
     "Never use media, ctaMedia, or reaction as the first generated body template, even with mediaType=gradient. Choose a non-media template first.",
     "Add that scene before resolving any stock or supplied asset. Media belongs on later body scenes and must arrive without blocking scene additions.",
-    "The raw input is the complete factual boundary. Do not add outside claims.",
+    "Use only claims supported by the factual basis permitted by the trusted system prompt.",
     "Select the most decision-relevant grounded takeaways that fit the duration; represent each selected takeaway once before completing the response.",
     "For a long source, summarize instead of attempting to represent every fact, unless the creative instructions explicitly request complete fact coverage that fits the duration.",
-    "Preserve exact wording and numbers for the takeaways you select. Preserve qualifiers, units, denominators, ranges, and comparison direction; for example, do not shorten 4.8 out of 5 to 4.8.",
+    "When selecting claims from the raw input, preserve their exact wording and numbers. Preserve qualifiers, units, denominators, ranges, and comparison direction; for example, do not shorten 4.8 out of 5 to 4.8.",
     "Choose the scene count from the distinct grounded material and the duration budget. Use fewer scenes for sparse input; continue beyond five when rich input warrants it and timing allows.",
+    "If the creative instructions explicitly require one separate scene per named item, release, section, or list entry, do not merge, group, or omit those required items. Keep related required scenes adjacent in a coherent progression while preserving each item as its own scene.",
+    "Before emitting, verify that the explicitly requested structure can fit readably within the maximum duration. If it cannot, preserve readability and the requested separation for the scenes that fit, then finish with plan.complete using finishReason length rather than silently changing the structure.",
+    "For ordinary multi-fact input, form at least three distinct beats: hook, comprehension, and payoff. Use only one or two beats when the source genuinely contains no more than two independent grounded takeaways. This is a narrative guideline, never permission to repeat facts or add filler.",
+    "After the first playable body scene, emit exactly one scene.add with placement closer. Generate a short grounded conclusion that answers the story's so-what; it must not repeat hook language or imply another scene follows.",
     "Use a different suitable template for each body scene when the catalog supports it.",
     "Never add filler to satisfy a count or diversity target.",
-    input.suppliedMedia?.length ? "Select zero or more relevant opaque supplied-media references for visible later scenes. Never invent or transform a reference, and never emit mediaKeyword without a resolved mediaUrl." : "Use asset-free templates. No media URL has been supplied or resolved. Never emit mediaKeyword without a resolved mediaUrl.",
+    input.suppliedMedia?.length ? "Select zero or more relevant opaque supplied-media references for visible later scenes. Never invent or transform a reference. Only emit mediaKeyword when the trusted system catalog explicitly exposes it, and only on later scenes. Never invent mediaUrl or mediaPoster." : "No supplied media URL is available. Use asset-free templates unless the trusted system catalog explicitly permits host-resolved media intent. Only emit mediaKeyword when the trusted system catalog explicitly exposes it, and only on later scenes. Never invent mediaUrl or mediaPoster.",
     "",
     "RAW INPUT",
     input.input.trim(),
@@ -130,6 +135,20 @@ function buildVideoUserPrompt(input, openingDurationSec = 0) {
 }
 
 // src/server/compose-video.ts
+var DEFAULT_OPENING_TEXT = "Creating your video...";
+function resolveVideoInput(input) {
+  return {
+    ...input,
+    opening: input.opening?.trim() || DEFAULT_OPENING_TEXT
+  };
+}
+function resolveStreamCapabilities(capabilities) {
+  if (capabilities?.templates == null) return capabilities;
+  return {
+    ...capabilities,
+    templates: [.../* @__PURE__ */ new Set(["media", ...capabilities.templates])]
+  };
+}
 function invokeIsolated(callback, value) {
   if (!callback) return;
   try {
@@ -158,12 +177,12 @@ function buildInitialConfig(input, audio, snapshotRetention, closerReserveSec, g
   const openingText = input.opening?.trim();
   const rawScenes = openingText ? [{
     id: "supplied-opening",
-    templateId: "notification",
+    templateId: "media",
     variables: {
-      appName: input.brand?.name ?? "",
-      message: openingText
+      texts: openingText,
+      mediaType: "gradient"
     },
-    timing: { fixedDuration: 5 }
+    timing: { fixedDuration: 3 }
   }] : [];
   const scenes = [];
   const warnings = [];
@@ -213,6 +232,9 @@ function buildInitialConfig(input, audio, snapshotRetention, closerReserveSec, g
 }
 function validateInput(input) {
   if (!input.input.trim()) throw new Error("Video response input is required");
+  if (input.knowledgeMode != null && input.knowledgeMode !== "input-only" && input.knowledgeMode !== "general") {
+    throw new Error("Video response knowledge mode must be input-only or general");
+  }
   if (input.maxDurationSec != null && (!Number.isFinite(input.maxDurationSec) || input.maxDurationSec < 5 || input.maxDurationSec > 120)) {
     throw new Error("Video response maximum duration must be between 5 and 120 seconds");
   }
@@ -252,11 +274,42 @@ function createOmittedForCloserWarning(sceneId) {
   return {
     code: "scene_omitted_for_closer",
     category: "readability",
-    message: "Scene was omitted because the final action must remain the last scene.",
+    message: "Scene was omitted because the reserved closer must remain the last scene.",
     sceneId,
     recoverable: true
   };
 }
+function createDuplicateCloserWarning() {
+  return {
+    code: "scene_omitted_for_closer",
+    category: "readability",
+    message: "An additional closer was omitted because the first valid closer is already reserved.",
+    recoverable: true
+  };
+}
+function createIncompletePlanWarning() {
+  return {
+    code: "plan_incomplete",
+    category: "provider",
+    message: "The planner stopped at a length limit; some requested scenes or the ending may be missing.",
+    recoverable: true
+  };
+}
+function createMissingCloserWarning() {
+  return {
+    code: "plan_missing_closer",
+    category: "provider",
+    message: "The planner completed without a valid closer; the video may end on a body scene.",
+    recoverable: true
+  };
+}
+function pendingCloserReserve(scene, getTemplatePacing) {
+  const metadata = getTemplatePacing?.(scene.templateId);
+  const readableMinimum = getReadableSceneDuration(scene, metadata);
+  const explicitRange = scene.timing.startTime != null && scene.timing.endTime != null ? Math.max(0, scene.timing.endTime - scene.timing.startTime) : void 0;
+  const requested = explicitRange ?? scene.timing.fixedDuration ?? metadata?.preferredDuration ?? readableMinimum;
+  return Math.max(readableMinimum, requested);
+}
 function sceneSlotDuration(scene) {
   return Math.max(0, (scene.timing.endTime ?? 0) - (scene.timing.startTime ?? 0));
 }
@@ -276,11 +329,10 @@ function createSceneQualityWarnings(scene) {
     recoverable: true
   }];
 }
-function createVideo(input, options) {
-  validateInput(input);
-  if (input.opening?.trim() && options.capabilities?.templates != null && !options.capabilities.templates.includes("notification")) {
-    throw new Error("Scene template notification was not negotiated");
-  }
+function createVideo(rawInput, options) {
+  validateInput(rawInput);
+  const usesDefaultOpening = rawInput.opening == null;
+  const input = resolveVideoInput(rawInput);
   const requestId = options.requestId ?? createId("request");
   const runId = options.runId ?? createId("run");
   const request = createVideoRequest(input, {
@@ -379,13 +431,22 @@ function createVideo(input, options) {
         resolveResult(finalState);
       }
     };
+    let planCompleted = false;
+    let generatedSceneCount = 0;
+    let runtimeDurationLimited = false;
+    let pendingCloser;
+    const deferredForCloser = [];
+    let plannerReportedLength = false;
+    let closerCommitted = false;
+    let missingCloser = false;
+    let finishReason = "stop";
     try {
       yield emit(events.create("response.start", {
         requestId,
         format: { orientation: initialConfig.orientation ?? "portrait" },
         style: initialConfig.style,
         meta: initialConfig.meta,
-        capabilities: options.capabilities
+        capabilities: resolveStreamCapabilities(options.capabilities)
       }));
       if (initialConfig.audio) yield emit(events.create("audio.set", { audio: initialConfig.audio }));
       for (const warning of initial.warnings) {
@@ -398,14 +459,7 @@ function createVideo(input, options) {
           revision: 0
         }));
       }
-      let planCompleted = false;
-      let generatedSceneCount = 0;
-      let runtimeDurationLimited = false;
-      let askAccepted = false;
-      const deferredForCloser = [];
-      let plannerReportedLength = false;
-      let finishReason = "stop";
-      const systemPrompt = options.systemPrompt ?? (await import("./system-prompt-A6UXNTPK.js")).DEFAULT_VIDEO_SYSTEM_PROMPT;
+      const systemPrompt = options.systemPrompt ?? (await import("./system-prompt-NMYHLAMJ.js")).createVideoSystemPrompt(input.knowledgeMode);
       const context = { request, systemPrompt, userPrompt, initialConfig, signal: controller.signal };
       attachGenerationLifecycleSink(context, lifecycle);
       for await (const untrustedPart of options.generate(context)) {
@@ -421,21 +475,29 @@ function createVideo(input, options) {
             if (options.capabilities?.templates != null && !options.capabilities.templates.includes(part.scene.templateId)) {
               throw new Error(`Scene template ${part.scene.templateId} was not negotiated`);
             }
-            if (askAccepted) {
-              runtimeDurationLimited = true;
-              rejectedSceneCount += 1;
-              yield emit(events.create("response.warning", {
-                warning: createOmittedForCloserWarning(part.scene.id)
-              }));
-              continue;
-            }
             options.validateScene?.(part.scene, {
               input,
               previousScenes: state.config?.scenes ?? []
             });
             const templatePacing = options.getTemplatePacing?.(part.scene.templateId);
             const isAskCandidate = templatePacing?.jobs?.includes("ask") === true;
-            if (deferredForCloser.length && !isAskCandidate) {
+            const isPayoffCandidate = templatePacing?.jobs?.includes("payoff") === true;
+            if (part.placement === "closer" && templatePacing && !isAskCandidate && !isPayoffCandidate) {
+              throw new Error(`Scene template ${part.scene.templateId} cannot be used as a closer`);
+            }
+            const isCloserCandidate = part.placement === "closer" || isAskCandidate;
+            if (isCloserCandidate) {
+              if (pendingCloser) {
+                rejectedSceneCount += 1;
+                yield emit(events.create("response.warning", {
+                  warning: createDuplicateCloserWarning()
+                }));
+              } else {
+                pendingCloser = part.scene;
+              }
+              continue;
+            }
+            if (deferredForCloser.length) {
               deferredForCloser.push(part.scene);
               continue;
             }
@@ -443,7 +505,7 @@ function createVideo(input, options) {
               previousScenes: state.config?.scenes ?? [],
               audio: state.config?.audio,
               maxDurationSec: input.maxDurationSec ?? 30,
-              closerReserveSec,
+              closerReserveSec: pendingCloser ? pendingCloserReserve(pendingCloser, options.getTemplatePacing) : closerReserveSec,
               getTemplatePacing: options.getTemplatePacing
             });
             if (!paced.scene) {
@@ -459,16 +521,6 @@ function createVideo(input, options) {
               continue;
             }
             const scene = paced.scene;
-            const isAsk = isAskCandidate;
-            if (isAsk && deferredForCloser.length) {
-              runtimeDurationLimited = true;
-              for (const deferred of deferredForCloser.splice(0)) {
-                rejectedSceneCount += 1;
-                yield emit(events.create("response.warning", {
-                  warning: createOmittedForCloserWarning(deferred.id)
-                }));
-              }
-            }
             for (const warning of paced.warnings) {
               yield emit(events.create("response.warning", { warning }));
             }
@@ -480,13 +532,24 @@ function createVideo(input, options) {
               position: state.config?.scenes.length ?? 0,
               revision: 0
             }));
-            if (isAsk) {
-              askAccepted = true;
-            }
             generatedSceneCount += 1;
             acceptedSceneCount += 1;
             timeToFirstSceneMs ??= Math.max(0, now() - startedAt);
           } else if (part.type === "scene.patch") {
+            if (pendingCloser?.id === part.sceneId) {
+              const nextPendingCloser = {
+                ...pendingCloser,
+                ...part.patch,
+                variables: part.patch.variables ? { ...pendingCloser.variables, ...part.patch.variables } : pendingCloser.variables,
+                timing: part.patch.timing ? { ...pendingCloser.timing, ...part.patch.timing } : pendingCloser.timing
+              };
+              options.validateScene?.(nextPendingCloser, {
+                input,
+                previousScenes: state.config?.scenes ?? []
+              });
+              pendingCloser = nextPendingCloser;
+              continue;
+            }
             const scenes = state.config?.scenes ?? [];
             const sceneIndex = scenes.findIndex((scene) => scene.id === part.sceneId);
             if (sceneIndex < 0) throw new Error(`Scene ${part.sceneId} does not exist`);
@@ -521,7 +584,7 @@ function createVideo(input, options) {
                 previousScenes: scenes.slice(0, sceneIndex),
                 audio: state.config?.audio,
                 maxDurationSec: input.maxDurationSec ?? 30,
-                closerReserveSec,
+                closerReserveSec: pendingCloser ? pendingCloserReserve(pendingCloser, options.getTemplatePacing) : closerReserveSec,
                 getTemplatePacing: options.getTemplatePacing
               });
               if (!pacedPatch.scene) {
@@ -561,6 +624,18 @@ function createVideo(input, options) {
               patch
             }));
           } else if (part.type === "asset.patch") {
+            if (pendingCloser?.id === part.sceneId) {
+              const nextPendingCloser = {
+                ...pendingCloser,
+                variables: { ...pendingCloser.variables, ...part.variables }
+              };
+              options.validateScene?.(nextPendingCloser, {
+                input,
+                previousScenes: state.config?.scenes ?? []
+              });
+              pendingCloser = nextPendingCloser;
+              continue;
+            }
             const scenes = state.config?.scenes ?? [];
             const scene = scenes.find((item) => item.id === part.sceneId);
             if (!scene) throw new Error(`Scene ${part.sceneId} does not exist`);
@@ -604,7 +679,39 @@ function createVideo(input, options) {
             yield errorEvent;
           } else if (part.type === "plan.complete") {
             if (planCompleted) throw new Error("The planner emitted plan.complete more than once");
-            if (!askAccepted && deferredForCloser.length) {
+            if (pendingCloser) {
+              if (deferredForCloser.length) runtimeDurationLimited = true;
+              for (const deferred of deferredForCloser.splice(0)) {
+                rejectedSceneCount += 1;
+                yield emit(events.create("response.warning", {
+                  warning: createOmittedForCloserWarning(deferred.id)
+                }));
+              }
+              const pacedCloser = paceScene(pendingCloser, {
+                previousScenes: state.config?.scenes ?? [],
+                audio: state.config?.audio,
+                maxDurationSec: input.maxDurationSec ?? 30,
+                closerReserveSec: 0,
+                getTemplatePacing: options.getTemplatePacing
+              });
+              for (const warning of pacedCloser.warnings) {
+                yield emit(events.create("response.warning", { warning }));
+              }
+              if (pacedCloser.scene) {
+                yield emit(events.create("scene.add", {
+                  scene: pacedCloser.scene,
+                  position: state.config?.scenes.length ?? 0,
+                  revision: 0
+                }));
+                generatedSceneCount += 1;
+                acceptedSceneCount += 1;
+                timeToFirstSceneMs ??= Math.max(0, now() - startedAt);
+                closerCommitted = true;
+              } else {
+                runtimeDurationLimited = true;
+                rejectedSceneCount += 1;
+              }
+            } else if (deferredForCloser.length) {
               for (const deferred of deferredForCloser.splice(0)) {
                 const recovered = paceScene(deferred, {
                   previousScenes: state.config?.scenes ?? [],
@@ -634,8 +741,15 @@ function createVideo(input, options) {
                 timeToFirstSceneMs ??= Math.max(0, now() - startedAt);
               }
             }
+            if (options.requireCloser && !closerCommitted) {
+              missingCloser = true;
+              yield emit(events.create("response.warning", {
+                warning: createMissingCloserWarning()
+              }));
+            }
             planCompleted = true;
-            finishReason = runtimeDurationLimited ? "length" : part.finishReason ?? "stop";
+            const reportedFinishReason = part.finishReason ?? "stop";
+            finishReason = runtimeDurationLimited ? "length" : reportedFinishReason !== "stop" ? reportedFinishReason : missingCloser ? "other" : "stop";
             plannerReportedLength = part.finishReason === "length";
             continue;
           }
@@ -665,7 +779,14 @@ function createVideo(input, options) {
       if (plannerReportedLength && generatedSceneCount === 0) {
         throw new Error("The planner was truncated before adding a generated scene");
       }
-      if (!state.config?.scenes.length) throw new Error("The planner completed without adding a scene");
+      if (plannerReportedLength) {
+        yield emit(events.create("response.warning", {
+          warning: createIncompletePlanWarning()
+        }));
+      }
+      if (generatedSceneCount === 0 && usesDefaultOpening) {
+        throw new Error("The planner completed without adding a scene");
+      }
       const snapshot = parseVideo(state.config);
       const completeEvent = emit(events.create("response.complete", {
         finishReason,
@@ -699,6 +820,28 @@ function createVideo(input, options) {
         return;
       }
       try {
+        if (pendingCloser && !closerCommitted && state.config?.scenes.length) {
+          const pacedCloser = paceScene(pendingCloser, {
+            previousScenes: state.config.scenes,
+            audio: state.config.audio,
+            maxDurationSec: input.maxDurationSec ?? 30,
+            closerReserveSec: 0,
+            getTemplatePacing: options.getTemplatePacing
+          });
+          for (const warning of pacedCloser.warnings) {
+            yield emit(events.create("response.warning", { warning }));
+          }
+          if (pacedCloser.scene) {
+            yield emit(events.create("scene.add", {
+              scene: pacedCloser.scene,
+              position: state.config.scenes.length,
+              revision: 0
+            }));
+            generatedSceneCount += 1;
+            acceptedSceneCount += 1;
+            closerCommitted = true;
+          }
+        }
         const provider = await settleProviderLifecycle();
         for (const warning of provider.warnings) {
           if (!state.warnings.some((existing) => existing.code === warning.code && existing.message === warning.message)) {

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import "./chunk-YC5MFXA5.js";
-import "./chunk-FQ47WXAJ.js";
-import "./chunk-EVG2ZYIY.js";
+import "./chunk-GR4I3MN2.js";
+import "./chunk-WHPZED7X.js";
+import "./chunk-3O7OMMMF.js";
 import {
   isTemplatePropertyFormatSupported,
   validateTemplateSchemaValue
@@ -9,13 +9,13 @@ import {
 import {
   getBuiltinTemplateMetadata,
   listBuiltinTemplateMetadata
-} from "./chunk-CHLGW22F.js";
+} from "./chunk-XAMUOSX7.js";
 import {
   assertTemplateTransitionMetadata
 } from "./chunk-2E6T633S.js";
 import {
   BUILTIN_TEMPLATE_MANIFEST
-} from "./chunk-W2XJKG6C.js";
+} from "./chunk-RBQN3VSY.js";
 import {
   getTemplateDefaults,
   isMeaningfullyPresentTemplateValue,

package/dist/{compose-video-CN3VSWST.js → compose-video-TQOHDXNW.js}

@@ -1,12 +1,12 @@
 import {
   createVideo
-} from "./chunk-IXCUY3B3.js";
+} from "./chunk-XYZOJ5NZ.js";
 import "./chunk-E7CL7UPB.js";
-import "./chunk-ABPKM4GK.js";
-import "./chunk-ERY4S6QV.js";
+import "./chunk-STIFILQG.js";
+import "./chunk-JW47XCRL.js";
 import "./chunk-GHJEAP4O.js";
 import "./chunk-EE6PK6XC.js";
-import "./chunk-EVG2ZYIY.js";
+import "./chunk-3O7OMMMF.js";
 import "./chunk-XGRA2MUV.js";
 export {
   createVideo

package/dist/{events-_wfjbmEp.d.ts → events-CTIsANzz.d.ts}

@@ -1,7 +1,7 @@
-import { e as VideoOrientation, g as VideoStyle, V as Video, j as VideoCapabilities, a as VideoAudio, f as VideoScene, k as VIDEO_PROTOCOL_VERSION } from './types-B-PZR6G_.js';
+import { f as VideoOrientation, h as VideoStyle, V as Video, k as VideoCapabilities, a as VideoAudio, g as VideoScene, l as VIDEO_PROTOCOL_VERSION } from './types-CkO2EYr4.js';
 
 type VideoWarningCategory = "validation" | "readability" | "grounding" | "provider" | "media" | "protocol";
-type VideoWarningCode = "scene_duration_adjusted" | "scene_omitted_unreadable" | "scene_omitted_for_closer" | "scene_patch_rejected_readability" | "chart_scale_imbalance" | "provider_warning" | "provider_diagnostics_unavailable";
+type VideoWarningCode = "scene_duration_adjusted" | "scene_omitted_unreadable" | "scene_omitted_for_closer" | "scene_patch_rejected_readability" | "chart_scale_imbalance" | "plan_incomplete" | "plan_missing_closer" | "provider_warning" | "provider_diagnostics_unavailable";
 /** A bounded, client-safe diagnostic that never includes provider payloads. */
 interface VideoWarning {
     code: VideoWarningCode;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { V as Video } from './types-B-PZR6G_.js';
-export { a as VideoAudio, b as VideoBackground, c as VideoBrand, d as VideoInput, e as VideoOrientation, f as VideoScene, g as VideoStyle, h as VideoStyleOptions, i as VideoSuppliedMedia } from './types-B-PZR6G_.js';
+import { V as Video } from './types-CkO2EYr4.js';
+export { a as VideoAudio, b as VideoBackground, c as VideoBrand, d as VideoInput, e as VideoKnowledgeMode, f as VideoOrientation, g as VideoScene, h as VideoStyle, i as VideoStyleOptions, j as VideoSuppliedMedia } from './types-CkO2EYr4.js';
 export { V as VideoStatus } from './state-DZcKuS32.js';
 
 type VideoValidationErrorCode = "invalid_video" | "unsupported_video_version";

package/dist/{kit-BMNcHqa9.d.ts → kit-DA2cfJ96.d.ts}

@@ -1,4 +1,4 @@
-import { g as VideoStyle, j as VideoCapabilities } from './types-B-PZR6G_.js';
+import { h as VideoStyle, k as VideoCapabilities } from './types-CkO2EYr4.js';
 import { ComponentType } from 'react';
 import { S as SceneTemplateMetadata, d as TemplateJsonSchema, f as TemplateJsonSchemaProperty } from './catalog-types-BIhSpOWK.js';
 

package/dist/react.d.ts

@@ -1,11 +1,14 @@
 import { CSSProperties, ReactElement } from 'react';
-import { V as VideoEvent, a as VideoWarning } from './events-_wfjbmEp.js';
-import { e as VideoOrientation, V as Video, d as VideoInput } from './types-B-PZR6G_.js';
-import { T as TemplateRegistry } from './kit-BMNcHqa9.js';
+import { V as VideoEvent, a as VideoWarning } from './events-CTIsANzz.js';
+import { f as VideoOrientation, V as Video, d as VideoInput } from './types-CkO2EYr4.js';
+import { T as TemplateRegistry } from './kit-DA2cfJ96.js';
 import { V as VideoStatus } from './state-DZcKuS32.js';
 import './catalog-types-BIhSpOWK.js';
 
+type VideoPlaybackMode = "manual" | "muted-autoplay" | "autoplay-with-sound" | "autoplay-after-interaction";
 interface VideoPlayerSharedProps {
+    /** High-level startup policy. When set, this overrides autoPlay and startMuted. */
+    playbackMode?: VideoPlaybackMode;
     /** Initial playback state. Reduced-motion preferences take precedence. */
     autoPlay?: boolean;
     startMuted?: boolean;
@@ -78,4 +81,4 @@ interface UseVideoResult {
 }
 declare function useVideo(options?: UseVideoOptions): UseVideoResult;
 
-export { type UseVideoOptions, type UseVideoResult, VideoError, type VideoErrorOptions, VideoPlayer, type VideoPlayerProps, useVideo };
+export { type UseVideoOptions, type UseVideoResult, VideoError, type VideoErrorOptions, type VideoPlaybackMode, VideoPlayer, type VideoPlayerProps, useVideo };