@vanillaskyai/video 0.8.8 → 0.9.0

package/dist/{chunk-AITKH6QT.js → chunk-OR52UMSF.js}

@@ -1,6 +1,6 @@
 import {
   createVideoSystemPrompt
-} from "./chunk-5SLENAJW.js";
+} from "./chunk-PAJ44TFW.js";
 import {
   PACING_PLANNER_RULES
 } from "./chunk-3O7OMMMF.js";
@@ -15,7 +15,7 @@ function getStandardMediaResolverContract(schema) {
   const url = schema.properties.mediaUrl;
   const type = schema.properties.mediaType;
   const allowedTypes = new Set(type?.enum ?? []);
-  if (keyword?.format !== "stock-media-keyword" || url?.format !== "uri" || !["photo", "video", "gradient"].every((value) => allowedTypes.has(value))) {
+  if (keyword?.format !== "stock-media-keyword" || url?.format !== "uri" || !["photo", "video"].every((value) => allowedTypes.has(value))) {
     return void 0;
   }
   return {
@@ -26,6 +26,8 @@ function getStandardMediaResolverContract(schema) {
 // src/visual-system/catalog/prompt.ts
 function plannerProperty(property) {
   return {
+    ...property.description == null ? {} : { description: property.description },
+    ...property.examples == null ? {} : { examples: property.examples.slice(0, 1) },
     ...property.type == null ? {} : { type: property.type },
     ...property.format == null ? {} : { format: property.format },
     ...property.enum == null ? {} : { enum: property.enum },
@@ -60,10 +62,6 @@ function plannerSchema(schema, exposeMediaKeyword) {
     }
   };
 }
-function needsPlannerSchema(schema) {
-  const visit = (property) => property.minimum != null || property.maximum != null || property.type === "object" || property.items != null && visit(property.items);
-  return Object.values(schema.properties).some(visit);
-}
 function isMediaProperty(property) {
   return property?.format === "uri" || property?.format === "supplied-image" || property?.format === "stock-media-keyword";
 }
@@ -71,13 +69,6 @@ function requiresAvailableMedia(template) {
   const gates = getTemplateSchemaGates(template.schema);
   return (template.schema.required ?? []).some((name) => isMediaProperty(template.schema.properties[name])) || gates.requiredAnyOf.some((group) => group.every((name) => isMediaProperty(template.schema.properties[name])));
 }
-var COMMON_MEDIA_VARIABLES = {
-  mediaUrl: "media",
-  mediaType: "enum(auto|photo|video|gradient)",
-  mediaPoster: "media",
-  mediaPosition: "enum(center|top|bottom|left|right)",
-  mediaTreatment: "enum(none|subtle|cinematic|text-safe)"
-};
 function plannerCatalog(templates, mediaResolverAvailable) {
   return templates.map((template) => {
     const gates = getTemplateSchemaGates(template.schema);
@@ -88,23 +79,19 @@ function plannerCatalog(templates, mediaResolverAvailable) {
         name === "mediaKeyword" ? "string{2..80}" : templateVariableNotation(property, template.schema.required?.includes(name) === true)
       ])
     );
-    const usesCommonMedia = Object.entries(COMMON_MEDIA_VARIABLES).every(([name, notation]) => variables[name] === notation);
-    if (usesCommonMedia) {
-      for (const name of Object.keys(COMMON_MEDIA_VARIABLES)) delete variables[name];
-    }
     return {
       id: template.id,
       jobs: template.jobs,
       use: template.useWhen ?? template.description,
+      ...template.avoidWhen ? { avoid: template.avoidWhen } : {},
       ...template.minDuration == null && template.preferredDuration == null ? {} : {
         seconds: [template.minDuration ?? null, template.preferredDuration ?? null]
       },
       ...gates.requiresStat ? { requiresStat: true } : {},
       ...gates.requiresQuote ? { requiresQuote: true } : {},
       ...gates.requiresScreenshot ? { requiresScreenshot: true } : {},
-      ...gates.requiredAnyOf.length > 0 ? { requiredAnyOf: gates.requiredAnyOf } : {},
-      ...needsPlannerSchema(template.schema) ? { schema: plannerSchema(template.schema, exposeMediaKeyword) } : {},
-      ...usesCommonMedia ? { media: true } : {},
+      ...gates.requiredAnyOf.length > 0 ? { requiredAnyOf: gates.requiredAnyOf.map((group) => group.filter((name) => name !== "mediaKeyword" || exposeMediaKeyword)) } : {},
+      schema: plannerSchema(template.schema, exposeMediaKeyword),
       variables
     };
   });
@@ -112,24 +99,14 @@ function plannerCatalog(templates, mediaResolverAvailable) {
 function createTemplateSystemPrompt(options) {
   const templates = options.kit.listTemplateMetadata().filter((template) => !requiresAvailableMedia(template) || options.suppliedMediaAvailable === true || options.mediaResolverAvailable === true && getStandardMediaResolverContract(template.schema) != null);
   const resolverMediaAvailable = options.mediaResolverAvailable === true && templates.some(({ schema }) => getStandardMediaResolverContract(schema) != null);
-  const ids = new Set(templates.map(({ id }) => id));
-  const fields = new Set(templates.flatMap(({ schema }) => Object.keys(schema.properties)));
   const basePrompt = createVideoSystemPrompt(options.knowledgeMode, options.narrate === true).split("\n").filter(
     (line) => !line.includes("Never use media, ctaMedia, or reaction as the first generated body template") && // The rule that keeps the opening beat asset-free belongs to the same
     // pair as the one below it: both exist so playback can start without
     // waiting on a provider, and both go when the host owns that wait.
     !(options.mediaOnFirstScene === true && line.includes("The first generated body scene must be asset-free")) && !(resolverMediaAvailable && line.includes("Never expose a loading placeholder or unresolved media keyword"))
   ).join("\n");
-  const factRules = [
-    ...ids.has("cardList") ? ["cardList needs two or three unused parallel facts"] : [],
-    ...ids.has("steps") ? ["steps needs two or three unused sequential facts"] : [],
-    ...ids.has("tripleStats") ? ["tripleStats needs exactly three unused peer values"] : []
-  ];
-  const mediaTemplates = ["media", "ctaMedia", "reaction"].filter((id) => ids.has(id));
-  const mediaTemplateNames = mediaTemplates.length === 3 ? "media, ctaMedia, and reaction" : mediaTemplates.join(", ");
-  const terminalPayoffs = ["media", "emojiBurst", "confetti"].filter((id) => ids.has(id));
-  const terminalPayoffNames = terminalPayoffs.length < 2 ? terminalPayoffs.join("") : `${terminalPayoffs.slice(0, -1).join(", ")}, or ${terminalPayoffs.at(-1)}`;
-  const listFields = ["items", "itemEmojis", "steps", "stepEmojis", "problemEmojis", "solutionEmojis"].filter((name) => fields.has(name));
+  const mediaTemplates = templates.filter(({ schema }) => getStandardMediaResolverContract(schema) != null).map(({ id }) => id);
+  const terminalPayoffs = templates.filter(({ jobs }) => jobs?.includes("payoff")).map(({ id }) => id);
   return [
     basePrompt.trim(),
     options.basePrompt?.trim() ? `
@@ -139,20 +116,17 @@ ${options.basePrompt.trim()}` : void 0,
     "TRUSTED TEMPLATE CATALOG",
     "Only use template IDs from this catalog. Only emit variables declared for the selected template.",
     "Variable notation is type[count]{characters}(options)! where count is list cardinality, characters is the inclusive character count for a string or each string-array item, and ! means required. Omitted ! means optional.",
-    `seconds is [minimum, preferred]. media=true adds these optional variables: ${Object.entries(COMMON_MEDIA_VARIABLES).map(([name, notation]) => `${name}:${notation}`).join(", ")}.`,
     "Choose a template only when the permitted factual basis contains every fact it needs. Never invent peer values to complete a chart, comparison, stat set, timeline, or list.",
     ...PACING_PLANNER_RULES,
-    ids.has("cardList") && ids.has("steps") && ids.has("tripleStats") ? "Fact availability carries across templates: cardList and steps each need two or three unused facts (parallel for cardList, sequential for steps) and must carry only the count the evidence supports, and tripleStats needs exactly three unused peer values. Never invent a fact to fill a collection, and do not fill one with facts already shown in another scene." : factRules.length > 0 ? `Fact availability carries across templates: ${factRules.join(", and ")}. Use only the count the evidence supports. Never invent a fact to fill a collection, and do not fill one with facts already shown in another scene.` : void 0,
     "Do not compress a list, sequence, metric set, or comparison into a general-purpose prose field when a specific catalog template can show that structure.",
     "If the catalog includes a suitable ask template and the input supplies a grounded CTA or URL, keep that concise action closer as its own final scene instead of folding it into preceding content.",
     "When a grounded CTA or URL is supplied and the catalog contains jobs:[ask], emit that final closer. A brand name may accompany the action but never qualifies as an ask by itself.",
-    terminalPayoffs.length > 0 ? `When the input has no clear grounded action, never invent one and do not use jobs:[ask]. End with a grounded payoff using ${terminalPayoffNames}. Its concise 6\u201312 words of declarative copy must answer the story's so-what without repeating hook or setup language. Use media for an honest visual payoff, emojiBurst for playful delight, and confetti only for a real celebration, win, or milestone.` : void 0,
+    terminalPayoffs.length > 0 ? `When there is no grounded action, end with a concise supported payoff using a suitable template from ${terminalPayoffs.join(", ")}. Do not repeat the hook or invent a CTA.` : void 0,
     "requiresQuote is a hard gate: use those templates only for exact quoted words and attribution present in raw input. Never turn a role, relationship, or summary into speech. requiresScreenshot likewise needs an actual supplied screenshot URL.",
     templates.some(({ schema }) => (schema["x-vanillasky"]?.requiredAnyOf?.length ?? 0) > 0) ? "requiredAnyOf is a hard presence gate: satisfy every listed group with at least one non-empty value." : void 0,
-    mediaTemplates.length > 0 && options.mediaOnFirstScene !== true ? `For streaming startup, ${mediaTemplateNames} ${mediaTemplates.length === 1 ? "is" : "are"} forbidden as the first generated body template, even when mediaType is gradient. Start with a content-fit non-media template.` : void 0,
-    listFields.length > 0 ? `For list variables (${listFields.join(", ")}), emit actual JSON arrays. Keep list labels to 1\u20133 words. Keep step labels to 1\u20132 words and at most 18 characters. Do not use pipes or newlines as list delimiters.` : void 0,
-    fields.has("bars") ? 'For bars, emit an actual JSON array of 2\u20136 grounded objects with "label" and "value" fields. Use comparable units and avoid a largest-to-smallest positive ratio above 20. Do not encode bars as a string.' : void 0,
-    resolverMediaAvailable ? `Prefer a relevant resolved image or video background on ${options.mediaOnFirstScene === true ? "every media-capable scene, the first included," : "later media-capable scenes"} whenever the permitted factual basis names a concrete person, place, product context, activity, or outcome that can be depicted honestly. Emit mediaKeyword on scene.add as a specific 2\u20138 word semantic query of at most 80 characters. The host removes mediaKeyword before the complete scene reaches the browser and replaces it with an approved asset. Use mediaType=gradient for abstract, sensitive, unsafe, or visually ambiguous material. Never emit or invent mediaUrl or mediaPoster.` : mediaTemplates.length > 0 ? `Use exact grounded values for required fields. mediaUrl must come verbatim from supplied input. Stock queries are not available. Do not select ${mediaTemplateNames} without a supplied mediaUrl; if another template has no mediaUrl, explicitly use mediaType=gradient. mediaType auto detects a URL, while gradient deliberately uses no external asset.` : "Use exact grounded values for required fields.",
+    mediaTemplates.length > 0 && options.mediaOnFirstScene !== true ? `The host owns immediate startup; reserve external media templates (${mediaTemplates.join(", ")}) for later beats when an asset-free opening is required.` : void 0,
+    "For list and event variables emit actual JSON arrays. Follow each field's content budget; never use pipe-delimited strings or invent entries.",
+    resolverMediaAvailable ? "Media-capable scenes may carry mediaKeyword: a literal 2\u20138 word shot description, at most 80 characters. Choose mediaSource=generate for distinctive illustrative shots and mediaSource=stock for common subjects a verified asset can depict. For generated footage, optional shotDirection gives action, framing and continuity separately from the stock query. Keep people, actions and essential details precise. Never broaden an exact identity or action into unrelated atmosphere. Supply a grounded fallbackText where declared. Only the host fills mediaUrl and mediaPoster; never invent them. If no media fits an abstract beat, choose an appropriate graphic template instead." : "Use media only when a supplied asset satisfies the scene. Never invent asset URLs. Otherwise choose a grounded graphic template.",
     "Catalog guidance describes composition; it is not a factual source and must never replace the permitted factual basis.",
     JSON.stringify(plannerCatalog(templates, resolverMediaAvailable)),
     // Last, because the catalogue is thousands of tokens of per-scene field

package/dist/{chunk-5SLENAJW.js → chunk-PAJ44TFW.js}

@@ -42,13 +42,12 @@ Composition rules:
 - Before emitting, assign each supported fact to at most one scene. The supplied opening counts: once a fact is visible, treat it as unavailable to later scenes. Finish when the supported material is covered instead of padding the response.
 - Do not infer that something is scheduled, ready, triggered, enabled, automatic, causal, or available unless the permitted factual basis supports it.
 - The first generated body scene must be asset-free and fully playable before any external media resolves.
-- Never use media, ctaMedia, or reaction as the first generated body template, including in gradient mode.
 - Use only media URLs present in the supplied input or already resolved by the host. Never expose a loading placeholder or unresolved media keyword. Audio is optional and must never delay the first scene.
 - Audio is selected by the host before generation. Never emit audio.
 
 Streaming rules:
 - Emit every scene once as a complete scene.add.
-- Emit exactly one closer immediately after the first playable body scene using placement:"closer". The runtime holds that closer and appends it last while later body scenes continue streaming.
+- Emit exactly one closer using placement:"closer". It is held and appended last; preserve the intended story order.
 - Prefer resolved media on scene.add. Scenes are immutable after emission.
 - End explicitly with plan.complete. A truncated stream is never treated as complete.
 - Return only plan parts accepted by the provided schema.

package/dist/{chunk-L7QGGKJ2.js → chunk-PDQFQIQW.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-E7CL7UPB.js";
 import {
   parseVideoPlanPart
-} from "./chunk-MMUXVA47.js";
+} from "./chunk-7M56IUUX.js";
 
 // src/server/model/truncated-json.ts
 function isConfidentlyTruncatedJson(source) {

package/dist/{chunk-WJ6FLKNC.js → chunk-R3XAOMKP.js}

@@ -1,5 +1,18 @@
 // src/visual-system/catalog/video-backdrop-capability.ts
 var EXTERNAL_VIDEO_BACKDROP_CAPABILITY = "__vanillaskyExternalVideoBackdrop";
+function markExternalVideoBackdropTemplate(template) {
+  const component = template.component;
+  if ((typeof component !== "object" || component === null) && typeof component !== "function") {
+    throw new Error("External video backdrop templates require a component");
+  }
+  Object.defineProperty(component, EXTERNAL_VIDEO_BACKDROP_CAPABILITY, {
+    value: true,
+    enumerable: false,
+    configurable: false,
+    writable: false
+  });
+  return template;
+}
 function supportsExternalVideoBackdrop(template) {
   if (typeof template !== "object" || template === null) return false;
   const component = template.component;
@@ -10,6 +23,7 @@ function externalVideoBackdropCapabilitySource() {
 }
 
 export {
+  markExternalVideoBackdropTemplate,
   supportsExternalVideoBackdrop,
   externalVideoBackdropCapabilitySource
 };

package/dist/{chunk-2OKB27TG.js → chunk-RXTN2CW6.js}

@@ -1,10 +1,10 @@
 import {
   parseVideoEvent
-} from "./chunk-MMUXVA47.js";
+} from "./chunk-7M56IUUX.js";
 import {
   VIDEO_PROTOCOL_VERSION,
   VIDEO_SCHEMA_VERSION
-} from "./chunk-AOWSXU2K.js";
+} from "./chunk-7NZOMTAL.js";
 
 // src/protocol/stable-json.ts
 function stableJson(value) {

package/dist/{chunk-XWWLKRNU.js → chunk-TVIU23OM.js}

@@ -1,23 +1,30 @@
-// src/visual-system/scene-templates/tokens.ts
-var TOKEN_DEFAULTS = {
-  /** Primary brand colour — CTA, highlights. */
-  primary: "#00E5A0",
-  /** Deepest background surface. */
-  surface: "#0A0A14",
-  /** Elevated card / panel surface. */
-  surfaceElevated: "#14152A",
-  /** Primary text color. */
-  foreground: "#FFFFFF",
-  /** Muted text — labels, footers, supporting copy. */
-  muted: "#A7A6B0",
-  /** Primary sans font family (first name of the stack). */
-  font: "Inter",
-  /** Script accent font family for handwritten callouts. */
-  scriptFont: "Caveat"
-};
-function fontStack(styleFont) {
-  return `${(styleFont || "").split(",")[0].trim() || TOKEN_DEFAULTS.font}, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Helvetica, Arial, sans-serif`;
+// src/visual-system/scene-templates/external-video-backdrop.tsx
+import React from "react";
+import { jsx } from "react/jsx-runtime";
+var DEFAULT = { mode: false, audioMuted: true, audioVolume: 1 };
+var sharedContext = globalThis;
+var BackdropContext = sharedContext.__vanillaskyVideoBackdropContext ??= React.createContext(DEFAULT);
+function ExternalVideoBackdropProvider({
+  mode,
+  audioMuted = true,
+  audioVolume = 1,
+  children
+}) {
+  const value = React.useMemo(
+    () => ({ mode, audioMuted, audioVolume }),
+    [mode, audioMuted, audioVolume]
+  );
+  return /* @__PURE__ */ jsx(BackdropContext.Provider, { value, children });
+}
+function useExternalVideoBackdrop() {
+  return React.useContext(BackdropContext).mode;
 }
+function useMediaAudio() {
+  const { audioMuted, audioVolume } = React.useContext(BackdropContext);
+  return { muted: audioMuted, volume: audioVolume };
+}
+
+// src/visual-system/scene-templates/tokens.ts
 var STYLE_PRESETS = {
   bold: {
     id: "bold",
@@ -94,7 +101,6 @@ function resolveMotion(id) {
   return id && MOTION_SCALES[id] || MOTION_SCALES[DEFAULT_MOTION_ID];
 }
 function resolveTokens(style) {
-  const brand = style.brand;
   const preset = resolvePreset(style.preset);
   const density = resolveDensity(style.density);
   const motion = resolveMotion(style.motion);
@@ -107,17 +113,15 @@ function resolveTokens(style) {
     }
   };
   return {
-    primary: brand.colors.primary,
-    secondary: brand.colors.secondary,
-    background: brand.background,
-    surface: brand.colors.surface,
-    surfaceElevated: brand.colors.surfaceElevated,
-    foreground: brand.colors.foreground,
-    muted: brand.colors.muted,
-    font: fontStack(brand.font),
-    scriptFont: brand.scriptFont,
-    logoUrl: brand.logoUrl,
-    name: brand.name,
+    primary: "#FFFFFF",
+    secondary: "#FFFFFF",
+    background: { type: "solid", color: "#000000" },
+    surface: "#000000",
+    surfaceElevated: "#171717",
+    foreground: "#FFFFFF",
+    muted: "#B7B7BC",
+    font: '-apple-system, BlinkMacSystemFont, "Helvetica Neue", Roboto, Arial, sans-serif',
+    scriptFont: "Georgia",
     preset: composedPreset,
     density,
     motion
@@ -131,27 +135,12 @@ function darken(hex, factor) {
   const ch = (i) => Math.max(0, Math.round(parseInt(full.slice(i, i + 2), 16) * (1 - factor))).toString(16).padStart(2, "0");
   return `#${ch(1)}${ch(3)}${ch(5)}`;
 }
-function lighten(hex, factor) {
-  if (!hex.startsWith("#") || hex.length !== 4 && hex.length !== 7) {
-    return hex;
-  }
-  const full = hex.length === 4 ? `#${hex[1]}${hex[1]}${hex[2]}${hex[2]}${hex[3]}${hex[3]}` : hex;
-  const r = parseInt(full.slice(1, 3), 16);
-  const g = parseInt(full.slice(3, 5), 16);
-  const b = parseInt(full.slice(5, 7), 16);
-  const lr = Math.min(255, Math.round(r + (255 - r) * factor));
-  const lg = Math.min(255, Math.round(g + (255 - g) * factor));
-  const lb = Math.min(255, Math.round(b + (255 - b) * factor));
-  return `#${lr.toString(16).padStart(2, "0")}${lg.toString(16).padStart(2, "0")}${lb.toString(16).padStart(2, "0")}`;
-}
-var MEDIA_TEXT_SHADOW = "0 2px 8px rgba(0,0,0,0.55), 0 6px 16px rgba(0,0,0,0.35)";
 
 export {
-  TOKEN_DEFAULTS,
-  fontStack,
   resolveDensity,
   resolveTokens,
   darken,
-  lighten,
-  MEDIA_TEXT_SHADOW
+  ExternalVideoBackdropProvider,
+  useExternalVideoBackdrop,
+  useMediaAudio
 };

package/dist/{chunk-224QNWRA.js → chunk-UDIODEDK.js}

@@ -19,12 +19,8 @@ function resolveMediaType(mediaType, mediaUrl) {
   if (mediaType === "photo") return "photo";
   return mediaUrl && isVideoUrl(mediaUrl) ? "video" : "photo";
 }
-function hasSceneMedia(variables) {
-  return String(variables.mediaUrl || "").trim() !== "" && String(variables.mediaType || "auto") !== "gradient";
-}
 
 export {
   limitsConcurrentVideoDecoders,
-  resolveMediaType,
-  hasSceneMedia
+  resolveMediaType
 };

package/dist/{chunk-3VRMKFM7.js → chunk-ZDJNFA52.js}

@@ -6,30 +6,27 @@ import {
   checksumVideo,
   createVideoEventFactory,
   createVideoState
-} from "./chunk-2OKB27TG.js";
+} from "./chunk-RXTN2CW6.js";
 import {
   parseVideoPlanPart,
   safePublicDiagnostic
-} from "./chunk-MMUXVA47.js";
+} from "./chunk-7M56IUUX.js";
 import {
   MAX_RETAINED_INSTRUCTIONS_LENGTH,
   MAX_RETAINED_MEDIA_URLS,
   MAX_RETAINED_MEDIA_URL_LENGTH,
   MAX_RETAINED_SOURCE_LENGTH,
   parseVideo
-} from "./chunk-2DOLF4QN.js";
+} from "./chunk-AUPC6MDK.js";
 import {
   VIDEO_SCHEMA_VERSION,
   createVideoRequest
-} from "./chunk-AOWSXU2K.js";
+} from "./chunk-7NZOMTAL.js";
 import {
   getCloserReserve,
   getReadableSceneDuration,
   paceScene
 } from "./chunk-3O7OMMMF.js";
-import {
-  resolveVideoBrand
-} from "./chunk-XGRA2MUV.js";
 
 // src/replayable-stream.ts
 function createReplayableStream(source, onError) {
@@ -114,7 +111,6 @@ function buildVideoUserPrompt(input, openingDurationSec = 0) {
     input.opening === false ? "The host owns the opening wait. Add the first grounded scene as soon as it is complete; it may use host-resolved media." : typeof input.opening === "string" && 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.",
     ...input.opening === false ? [] : [
       "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. Resolve media as part of each complete later body scene."
     ],
     "Use only claims supported by the factual basis permitted by the trusted system prompt.",
@@ -125,7 +121,7 @@ function buildVideoUserPrompt(input, openingDurationSec = 0) {
     "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.",
+    "Emit exactly one final 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 ? input.opening === false ? "Select zero or more relevant opaque supplied-media references for visible scenes. Never invent or transform a reference. Only emit mediaKeyword when the trusted system catalog explicitly exposes it. Never invent mediaUrl or mediaPoster." : "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." : input.opening === false ? "No supplied media URL is available. Use asset-free templates unless the trusted system catalog explicitly permits host-resolved media intent, which may begin on the first scene. Only emit mediaKeyword when the trusted system catalog explicitly exposes it. 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.",
@@ -140,13 +136,7 @@ function buildVideoUserPrompt(input, openingDurationSec = 0) {
     JSON.stringify(input.personalization ?? {}),
     "",
     "SUPPLIED MEDIA",
-    JSON.stringify(suppliedMediaReferences(input)),
-    "",
-    "BRAND",
-    JSON.stringify({
-      ...input.brand?.name?.trim() ? { name: input.brand.name.trim() } : {},
-      hasLogo: Boolean(input.brand?.logoUrl?.trim())
-    })
+    JSON.stringify(suppliedMediaReferences(input))
   ].join("\n");
 }
 
@@ -162,7 +152,7 @@ function resolveStreamCapabilities(capabilities, hasRuntimeOpening) {
   if (!hasRuntimeOpening || capabilities?.templates == null) return capabilities;
   return {
     ...capabilities,
-    templates: [.../* @__PURE__ */ new Set(["media", ...capabilities.templates])]
+    templates: [.../* @__PURE__ */ new Set(["chapterTitle", ...capabilities.templates])]
   };
 }
 function validateVideoInput(input) {
@@ -190,16 +180,14 @@ function validateVideoInput(input) {
       throw new Error(`Video response supplied media ${index} poster URL must be at most ${MAX_RETAINED_MEDIA_URL_LENGTH} characters`);
     }
   }
-  resolveVideoBrand(input.brand);
 }
 function buildInitialComposition(input, audio, snapshotRetention, closerReserveSec, getTemplatePacing) {
   const openingText = typeof input.opening === "string" ? input.opening.trim() : void 0;
   const openingScenes = openingText ? [{
     id: "supplied-opening",
-    templateId: "media",
+    templateId: "chapterTitle",
     variables: {
-      texts: openingText,
-      mediaType: "gradient"
+      title: openingText
     },
     timing: { fixedDuration: 3 }
   }] : [];
@@ -223,7 +211,7 @@ function buildInitialComposition(input, audio, snapshotRetention, closerReserveS
     warnings.push(...paced.warnings);
   }
   const meta = {
-    name: input.brand?.name?.trim() || "Video response"
+    name: "Video response"
   };
   if (snapshotRetention?.source) {
     meta.source = input.input.trim().slice(0, MAX_RETAINED_SOURCE_LENGTH);
@@ -241,7 +229,6 @@ function buildInitialComposition(input, audio, snapshotRetention, closerReserveS
       scenes,
       ...audio ? { audio } : {},
       style: {
-        brand: resolveVideoBrand(input.brand),
         density: input.style?.density ?? "normal",
         motion: input.style?.motion ?? "normal",
         defaultBackgroundEffect: input.style?.backgroundEffect ?? "static",
@@ -704,7 +691,7 @@ function createVideo(rawInput, options) {
           position
         }));
       }
-      const systemPrompt = options.systemPrompt ?? (await import("./system-prompt-RRXIWDDD.js")).createVideoSystemPrompt(input.knowledgeMode);
+      const systemPrompt = options.systemPrompt ?? (await import("./system-prompt-SYRT5DWM.js")).createVideoSystemPrompt(input.knowledgeMode);
       const context = { request, systemPrompt, userPrompt, initialConfig, signal: controller.signal };
       attachGenerationLifecycleSink(context, lifecycle);
       for await (const untrustedPart of options.generate(context)) {

package/dist/cinema-media-YQHSIFDA.js

@@ -0,0 +1,11 @@
+import {
+  MediaScene,
+  MediaSceneTemplate
+} from "./chunk-G7IZBBWF.js";
+import "./chunk-77VY4O7A.js";
+import "./chunk-UDIODEDK.js";
+import "./chunk-TVIU23OM.js";
+export {
+  MediaScene,
+  MediaSceneTemplate
+};

package/dist/cli.js

@@ -1,24 +1,24 @@
 #!/usr/bin/env node
-import "./chunk-AITKH6QT.js";
-import "./chunk-5SLENAJW.js";
+import "./chunk-OR52UMSF.js";
+import "./chunk-PAJ44TFW.js";
 import {
   isTemplatePropertyFormatSupported,
   validateTemplateSchemaValue
-} from "./chunk-352ZZCET.js";
+} from "./chunk-EGVQODKU.js";
 import {
   getBuiltinTemplateMetadata,
   listBuiltinTemplateMetadata
-} from "./chunk-4UNKZEAT.js";
+} from "./chunk-LH4BPALA.js";
 import "./chunk-3O7OMMMF.js";
 import {
   assertTemplateTransitionMetadata
 } from "./chunk-2E6T633S.js";
 import {
   BUILTIN_TEMPLATE_MANIFEST
-} from "./chunk-PP3MCPN4.js";
+} from "./chunk-MXEYPK7M.js";
 import {
   externalVideoBackdropCapabilitySource
-} from "./chunk-WJ6FLKNC.js";
+} from "./chunk-R3XAOMKP.js";
 import {
   getTemplateDefaults,
   isMeaningfullyPresentTemplateValue,
@@ -1006,8 +1006,12 @@ function validateDiscoveredTemplate(template, cwd) {
     validateSchema(metadata.schema);
     if (metadata.timing !== void 0) {
       if (!metadata.timing || typeof metadata.timing !== "object" || Array.isArray(metadata.timing)) throw new Error("timing must be an object");
-      for (const key of Object.keys(metadata.timing)) if (!(/* @__PURE__ */ new Set(["contentFields", "contentUnit"])).has(key)) throw new Error(`timing.${key} is not supported`);
-      if (!Array.isArray(metadata.timing.contentFields) || metadata.timing.contentFields.length === 0) throw new Error("timing.contentFields must contain at least one schema property");
+      for (const key of Object.keys(metadata.timing)) if (!(/* @__PURE__ */ new Set(["contentFields", "contentUnit", "revealSeconds", "holdSeconds", "exitSeconds"])).has(key)) throw new Error(`timing.${key} is not supported`);
+      if (!Array.isArray(metadata.timing.contentFields)) throw new Error("timing.contentFields must be an array of schema properties");
+      for (const key of ["revealSeconds", "holdSeconds", "exitSeconds"]) {
+        const value = metadata.timing[key];
+        if (value !== void 0 && (typeof value !== "number" || !Number.isFinite(value) || value < 0)) throw new Error(`timing.${key} must be a finite non-negative number`);
+      }
       const timingFields = /* @__PURE__ */ new Set();
       for (const field of metadata.timing.contentFields) {
         if (typeof field !== "string" || !Object.hasOwn(metadata.schema.properties, field)) throw new Error(`timing.contentFields references undeclared property ${JSON.stringify(field)}`);
@@ -1017,6 +1021,11 @@ function validateDiscoveredTemplate(template, cwd) {
       if (!CONTENT_UNITS.has(metadata.timing.contentUnit)) throw new Error("timing.contentUnit contains an unsupported value");
     }
     const defaults = getTemplateDefaults(metadata.schema);
+    const smokeVariables = { ...defaults };
+    for (const field of metadata.schema.required ?? []) {
+      const example = metadata.schema.properties[field]?.examples?.[0];
+      if (!(field in smokeVariables) && example !== void 0) smokeVariables[field] = example;
+    }
     if (template.examples !== void 0 && !Array.isArray(template.examples)) throw new Error("examples must be an array");
     const supplied = template.examples ?? [];
     for (const [index, value] of supplied.entries()) {
@@ -1031,7 +1040,7 @@ function validateDiscoveredTemplate(template, cwd) {
       name,
       variables: { ...defaults, ...variables },
       enforceRequiredAnyOf: true
-    })) : [{ name: "defaults", variables: defaults, enforceRequiredAnyOf: false }];
+    })) : [{ name: "defaults", variables: smokeVariables, enforceRequiredAnyOf: false }];
     const names = /* @__PURE__ */ new Set();
     for (const example of examples) {
       if (typeof example.name !== "string" || !example.name.trim()) throw new Error("example names must be non-empty strings");

package/dist/comparison-RZMMHZR2.js

@@ -0,0 +1,27 @@
+import {
+  editorialFont,
+  editorialLabel,
+  fade
+} from "./chunk-4YM2M62S.js";
+
+// src/visual-system/scene-templates/comparison.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+function ComparisonScene({ variables, width, height, progress, motionProgress = progress, safeZone }) {
+  const portrait = height > width, u = Math.min(width, height);
+  const side = Math.max(width * 0.12, safeZone.left, safeZone.right);
+  const top = Math.max(height * 0.2, safeZone.top), bottom = height - Math.max(height * 0.23, safeZone.bottom);
+  const area = bottom - top, cy = (top + bottom) / 2, available = width - side * 2;
+  const entries = [{ label: String(variables.leftLabel ?? ""), text: String(variables.leftText ?? "") }, { label: String(variables.rightLabel ?? ""), text: String(variables.rightText ?? "") }];
+  const textWidth = portrait ? available : available * 0.39;
+  return /* @__PURE__ */ jsxs("div", { "data-template": "comparison", style: { position: "absolute", inset: 0, background: "#000", color: "#fff", fontFamily: editorialFont, overflow: "hidden" }, children: [
+    /* @__PURE__ */ jsx("div", { "aria-hidden": "true", style: { position: "absolute", left: portrait ? width * 0.32 : width / 2, top: portrait ? cy : top + area * 0.18, width: portrait ? width * 0.36 : u * 1e-3, height: portrait ? u * 1e-3 : area * 0.64, background: "#fff", opacity: 0.22 * fade((motionProgress - 0.16) / 0.18) } }),
+    entries.map((entry, i) => /* @__PURE__ */ jsxs("div", { "data-comparison-side": i === 0 ? "left" : "right", style: { position: "absolute", left: portrait ? side : side + available * (i === 0 ? 0.055 : 0.555), top: portrait ? top + area * (i === 0 ? 0.25 : 0.75) : cy, width: textWidth, transform: "translateY(-50%)", textAlign: "center", opacity: fade((motionProgress - 0.04 - i * 0.22) / 0.2) }, children: [
+      entry.label && /* @__PURE__ */ jsx("div", { style: { ...editorialLabel(u), marginBottom: u * 0.028 }, children: entry.label }),
+      /* @__PURE__ */ jsx("div", { style: { fontSize: u * 0.058, fontWeight: 500, lineHeight: 1.22, letterSpacing: "-.025em", textWrap: "balance", overflowWrap: "anywhere" }, children: entry.text })
+    ] }, i))
+  ] });
+}
+var ComparisonSceneTemplate = ComparisonScene;
+export {
+  ComparisonSceneTemplate
+};

package/dist/compose-video-TBFTONUC.js

@@ -0,0 +1,12 @@
+import {
+  createVideo
+} from "./chunk-ZDJNFA52.js";
+import "./chunk-E7CL7UPB.js";
+import "./chunk-RXTN2CW6.js";
+import "./chunk-7M56IUUX.js";
+import "./chunk-AUPC6MDK.js";
+import "./chunk-7NZOMTAL.js";
+import "./chunk-3O7OMMMF.js";
+export {
+  createVideo
+};

package/dist/editorial-timeline-OZX7OS6G.js

@@ -0,0 +1,36 @@
+import {
+  editorialFont,
+  fade
+} from "./chunk-4YM2M62S.js";
+
+// src/visual-system/scene-templates/editorial-timeline.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+var timelineTiming = (index) => ({ nodeStart: index === 0 ? 0.06 : 0.23 + (index - 1) * 0.11, lineStart: 0.14 + index * 0.11, lineDuration: 0.09, entranceDuration: 0.16 });
+function TimelineScene({ variables, progress, motionProgress = progress, width, height, safeZone }) {
+  const events = (Array.isArray(variables.events) ? variables.events : []).slice(0, 5).map((e) => ({ label: String(e?.label ?? "") }));
+  const portrait = height > width, u = Math.min(width, height), n = Math.max(1, events.length);
+  const side = Math.max(width * 0.13, safeZone.left, safeZone.right), available = width - side * 2;
+  const top = Math.max(height * 0.2, safeZone.top), bottom = height - Math.max(height * 0.24, safeZone.bottom);
+  const slot = portrait ? (bottom - top) / n : available / n;
+  const points = events.map((_, i) => ({ x: portrait ? side : side + slot * (i + 0.5), y: portrait ? top + slot * (i + 0.5) : height * 0.43 }));
+  const radius = u * 45e-4;
+  return /* @__PURE__ */ jsxs("div", { "data-template": "timeline", style: { position: "absolute", inset: 0, overflow: "hidden", background: "#000", fontFamily: editorialFont, color: "#fff" }, children: [
+    points.slice(0, -1).map((point, i) => {
+      const next = points[i + 1], timing = timelineTiming(i), line = fade((motionProgress - timing.lineStart) / timing.lineDuration);
+      return /* @__PURE__ */ jsx("div", { "data-step-connector": "true", style: { position: "absolute", left: point.x, top: point.y, width: portrait ? u * 1e-3 : next.x - point.x, height: portrait ? next.y - point.y : u * 1e-3, background: "#fff", opacity: 0.3, transform: portrait ? `scaleY(${line})` : `scaleX(${line})`, transformOrigin: portrait ? "top" : "left" } }, `line-${i}`);
+    }),
+    points.map((point, i) => {
+      const timing = timelineTiming(i), event = events[i], opacity = fade((motionProgress - timing.nodeStart) / timing.entranceDuration);
+      const textW = portrait ? available - u * 0.055 : slot * 0.86;
+      return /* @__PURE__ */ jsxs("div", { "data-template-item": "steps", style: { opacity }, children: [
+        /* @__PURE__ */ jsx("div", { "aria-hidden": "true", style: { position: "absolute", left: point.x - radius, top: point.y - radius, width: radius * 2, height: radius * 2, borderRadius: "50%", background: "#fff" } }),
+        /* @__PURE__ */ jsx("div", { style: { position: "absolute", left: portrait ? point.x + u * 0.055 : point.x - textW / 2, top: portrait ? point.y : point.y + u * 0.05, width: textW, transform: portrait ? "translateY(-50%)" : void 0, textAlign: portrait ? "left" : "center" }, children: /* @__PURE__ */ jsx("div", { style: { fontSize: u * (portrait ? 0.052 : 0.041), fontWeight: 500, lineHeight: 1.22, letterSpacing: "-.025em", textWrap: "balance", overflowWrap: "anywhere" }, children: event.label }) })
+      ] }, i);
+    })
+  ] });
+}
+var TimelineSceneTemplate = TimelineScene;
+export {
+  TimelineSceneTemplate,
+  timelineTiming
+};

package/dist/{events-BQ6z264n.d.ts → events-B4YCc4vc.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-CEh9eUFu.js';
+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';
 
 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";