@vanillaskyai/video 0.1.1 → 0.2.0

package/dist/{chunk-IXCUY3B3.js → chunk-TGFO454Q.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";
@@ -105,9 +105,13 @@ function buildVideoUserPrompt(input, openingDurationSec = 0) {
     "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.",
     "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(),
@@ -158,12 +162,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 = [];
@@ -252,11 +256,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));
 }
@@ -278,8 +313,8 @@ function createSceneQualityWarnings(scene) {
 }
 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");
+  if (input.opening?.trim() && options.capabilities?.templates != null && !options.capabilities.templates.includes("media")) {
+    throw new Error("Scene template media was not negotiated");
   }
   const requestId = options.requestId ?? createId("request");
   const runId = options.runId ?? createId("run");
@@ -379,6 +414,15 @@ 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,
@@ -398,14 +442,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-GYTYGWGO.js")).DEFAULT_VIDEO_SYSTEM_PROMPT;
       const context = { request, systemPrompt, userPrompt, initialConfig, signal: controller.signal };
       attachGenerationLifecycleSink(context, lifecycle);
       for await (const untrustedPart of options.generate(context)) {
@@ -421,21 +458,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 +488,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 +504,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 +515,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 +567,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 +607,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 +662,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 +724,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,6 +762,11 @@ function createVideo(input, options) {
       if (plannerReportedLength && generatedSceneCount === 0) {
         throw new Error("The planner was truncated before adding a generated scene");
       }
+      if (plannerReportedLength) {
+        yield emit(events.create("response.warning", {
+          warning: createIncompletePlanWarning()
+        }));
+      }
       if (!state.config?.scenes.length) throw new Error("The planner completed without adding a scene");
       const snapshot = parseVideo(state.config);
       const completeEvent = emit(events.create("response.complete", {
@@ -699,6 +801,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/{chunk-CHLGW22F.js → chunk-XAMUOSX7.js}

@@ -7,7 +7,8 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
     "family": "Media & motion",
     "jobs": [
       "setup",
-      "atmosphere"
+      "atmosphere",
+      "payoff"
     ],
     "register": "motion-led",
     "useWhen": "A visual hook, scenic beat, or concrete product-context line benefits from immersive media.",
@@ -2405,8 +2406,7 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
     "description": "A single iMessage-style outgoing bubble floats over media or a brand gradient.",
     "family": "Social & messaging",
     "jobs": [
-      "claim",
-      "payoff"
+      "claim"
     ],
     "register": "card-led",
     "useWhen": "A direct one-to-one thank-you, invitation, promise, or concise launch note is the point.",

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-Q2DDQKEG.js";
+import "./chunk-K5SRF7D3.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-34GRZIF2.js}

@@ -1,12 +1,12 @@
 import {
   createVideo
-} from "./chunk-IXCUY3B3.js";
+} from "./chunk-TGFO454Q.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-B-28kERX.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 { 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-_t4bduwX.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-_t4bduwX.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-_t4bduwX.js';
 export { V as VideoStatus } from './state-DZcKuS32.js';
 
 type VideoValidationErrorCode = "invalid_video" | "unsupported_video_version";

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

@@ -1,4 +1,4 @@
-import { g as VideoStyle, j as VideoCapabilities } from './types-B-PZR6G_.js';
+import { g as VideoStyle, j as VideoCapabilities } from './types-_t4bduwX.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-B-28kERX.js';
+import { e as VideoOrientation, V as Video, d as VideoInput } from './types-_t4bduwX.js';
+import { T as TemplateRegistry } from './kit-CBedbj1n.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 };