@vanillaskyai/video 0.8.8 → 0.10.0

package/dist/{chunk-LMG3GHLL.js → chunk-IQMYK5DX.js}

@@ -1,6 +1,6 @@
 import {
   validateTemplateSchemaValue
-} from "./chunk-352ZZCET.js";
+} from "./chunk-EGVQODKU.js";
 import {
   getTemplateSchemaGates,
   isMeaningfullyPresentTemplateValue
@@ -29,7 +29,7 @@ function schemaValues(schema, variables) {
   }
   return values;
 }
-function validateSchema(schema, value) {
+function validateTemplateSceneStructure(schema, value, deferMediaUrls = false) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     throw new Error("Template variable variables must be object");
   }
@@ -45,6 +45,7 @@ function validateSchema(schema, value) {
   }
   for (const [name, property] of Object.entries(schema.properties)) {
     if (Object.hasOwn(object, name)) validateTemplateSchemaValue(property, object[name], name, {
+      deferMediaUrls,
       errorPrefix: "Template variable ",
       includeTypeArticle: true,
       allowEmptyOptionalMedia: property.default === "",
@@ -66,6 +67,24 @@ function suppliedUrls(input) {
   }
   return urls;
 }
+function containsSuppliedQuantity(input, value) {
+  if (typeof value !== "string" && typeof value !== "number") return false;
+  const normalize = (text) => text.normalize("NFKC").replace(/\u2212/g, "-").replace(/\s+/gu, " ").replace(/([\p{Sc}]) (?=[+−-]?\d)/gu, "$1").replace(/(\d) (?=[%‰])/gu, "$1").trim();
+  const quantity = normalize(String(value));
+  if (!/\d/u.test(quantity)) return false;
+  const source = normalize(input);
+  let offset = source.indexOf(quantity);
+  while (offset !== -1) {
+    const before = source.slice(0, offset);
+    const after = source.slice(offset + quantity.length);
+    const beginsInside = /[\p{L}\p{N}\p{Sc}%‰+−-]$/u.test(before) || /\d[.,]$/u.test(before);
+    const endsInside = /^[\p{L}\p{N}\p{Sc}%‰]/u.test(after) || /^[.,]\d/u.test(after);
+    const dropsUnit = /\d$/u.test(quantity) && /^ (?:%|‰|percent\b|per cent\b|thousand\b|million\b|billion\b|trillion\b|usd\b|eur\b|gbp\b|dollars?\b|euros?\b|pounds?\b)/iu.test(after);
+    if (!beginsInside && !endsInside && !dropsUnit) return true;
+    offset = source.indexOf(quantity, offset + 1);
+  }
+  return false;
+}
 function createTemplateSceneValidator(options) {
   return (scene, context) => {
     const template = options.kit.getTemplateMetadata(scene.templateId);
@@ -73,7 +92,7 @@ function createTemplateSceneValidator(options) {
     const schema = template.schema;
     const gates = getTemplateSchemaGates(schema);
     validateConditionalPresence(scene.templateId, gates.requiredAnyOf, scene.variables);
-    validateSchema(schema, scene.variables);
+    validateTemplateSceneStructure(schema, scene.variables);
     const values = schemaValues(schema, scene.variables);
     const allowedUrls = suppliedUrls(context.input);
     const suppliedImageUrls = new Set((context.input.suppliedMedia ?? []).filter(({ type }) => type === "image").map(({ url }) => url));
@@ -93,6 +112,12 @@ function createTemplateSceneValidator(options) {
       });
       if (!permitted) throw new Error(`Template variable ${path} must use supplied media`);
     }
+    if (gates.requiresStat) {
+      const quantities = values.filter(({ property }) => property.format === "grounded-stat");
+      if (!quantities.length || quantities.some(({ value }) => !containsSuppliedQuantity(context.input.input, value))) {
+        throw new Error(`Template ${scene.templateId} requires an exact supplied quantity, preserving its unit`);
+      }
+    }
     if (gates.requiresQuote) {
       const quoteValues = values.filter(({ property, value }) => property.format === "grounded-quote" && typeof value === "string" && value.trim()).map(({ value }) => String(value).trim());
       if (!quoteValues.length || quoteValues.some((quote) => !context.input.input.includes(quote))) {
@@ -103,5 +128,6 @@ function createTemplateSceneValidator(options) {
 }
 
 export {
+  validateTemplateSceneStructure,
   createTemplateSceneValidator
 };

package/dist/{chunk-OWBT45EN.js → chunk-IR44XKBI.js}

@@ -1,6 +1,6 @@
 import {
   BUILTIN_TEMPLATE_CATALOG
-} from "./chunk-4UNKZEAT.js";
+} from "./chunk-IIN5M5HW.js";
 import {
   assertTemplateTransitionMetadata
 } from "./chunk-2E6T633S.js";

package/dist/{chunk-MXZSDGZQ.js → chunk-NMFDC2W2.js}

@@ -1,17 +1,15 @@
 import {
+  BrandGradientOverlay,
   SceneVideoBackdrop,
+  getBackgroundTransform,
   resolveMediaPosition
-} from "./chunk-FRN6WKHA.js";
-import {
-  BrandGradientOverlay,
-  getBackgroundTransform
-} from "./chunk-W3VDIBGR.js";
+} from "./chunk-77VY4O7A.js";
 import {
   resolveMediaType
 } from "./chunk-224QNWRA.js";
 import {
   useExternalVideoBackdrop
-} from "./chunk-5CDAM24P.js";
+} from "./chunk-TVIU23OM.js";
 
 // src/visual-system/scene-templates/scene-background.tsx
 import { useEffect, useState } from "react";

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-XX4GXKTX.js

@@ -0,0 +1,35 @@
+import {
+  SceneBackground,
+  getMediaBackgroundProps
+} from "./chunk-NMFDC2W2.js";
+import {
+  editorialFont
+} from "./chunk-4YM2M62S.js";
+import {
+  hasSceneMedia
+} from "./chunk-224QNWRA.js";
+
+// src/visual-system/scene-templates/editorial-background.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+function EditorialSurface({ children, template, ...props }) {
+  const { variables, style, width, height, progress, sceneDuration, isPlaying } = props;
+  const overMedia = hasSceneMedia(variables), u = Math.min(width, height);
+  const surface = {
+    position: "absolute",
+    inset: 0,
+    overflow: "hidden",
+    background: overMedia ? "var(--vanillasky-template-surface, #000)" : "#000",
+    fontFamily: editorialFont,
+    color: "#fff",
+    // Two soft, scale-aware shadows preserve local contrast without outlining type.
+    textShadow: overMedia ? `0 ${u * 2e-3}px ${u * 8e-3}px rgba(0,0,0,.65), 0 ${u * 6e-3}px ${u * 0.016}px rgba(0,0,0,.4)` : void 0
+  };
+  return /* @__PURE__ */ jsxs("div", { "data-template": template, style: surface, children: [
+    overMedia && /* @__PURE__ */ jsx(SceneBackground, { style, width, height, progress, sceneDuration, ...getMediaBackgroundProps(variables), mediaTreatment: "cinematic", textAnchor: "center", backgroundEffect: "none", isPlaying }),
+    children
+  ] });
+}
+
+export {
+  EditorialSurface
+};

package/dist/chunk-Z67Q5KUW.js

@@ -0,0 +1,16 @@
+import {
+  SceneBackground,
+  getMediaBackgroundProps
+} from "./chunk-NMFDC2W2.js";
+
+// src/visual-system/scene-templates/cinema-media.tsx
+import { jsx } from "react/jsx-runtime";
+function MediaScene({ variables, style, width, height, progress, sceneDuration, isPlaying }) {
+  return /* @__PURE__ */ jsx("div", { "data-template": "cinemaMedia", style: { width, height, position: "relative", overflow: "hidden" }, children: /* @__PURE__ */ jsx(SceneBackground, { style, width, height, progress, sceneDuration, ...getMediaBackgroundProps(variables), mediaTreatment: "none", backgroundEffect: "none", isPlaying }) });
+}
+var MediaSceneTemplate = MediaScene;
+
+export {
+  MediaScene,
+  MediaSceneTemplate
+};

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-C7OUPNSH.js

@@ -0,0 +1,12 @@
+import {
+  MediaScene,
+  MediaSceneTemplate
+} from "./chunk-Z67Q5KUW.js";
+import "./chunk-NMFDC2W2.js";
+import "./chunk-77VY4O7A.js";
+import "./chunk-224QNWRA.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-2HFO22K2.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-IIN5M5HW.js";
 import "./chunk-3O7OMMMF.js";
 import {
   assertTemplateTransitionMetadata
 } from "./chunk-2E6T633S.js";
 import {
   BUILTIN_TEMPLATE_MANIFEST
-} from "./chunk-PP3MCPN4.js";
+} from "./chunk-4ZJLPHBV.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-GNZOR7MF.js

@@ -0,0 +1,37 @@
+import {
+  EditorialSurface
+} from "./chunk-XX4GXKTX.js";
+import "./chunk-NMFDC2W2.js";
+import "./chunk-77VY4O7A.js";
+import {
+  editorialLabel,
+  fade
+} from "./chunk-4YM2M62S.js";
+import {
+  hasSceneMedia
+} from "./chunk-224QNWRA.js";
+import "./chunk-TVIU23OM.js";
+
+// src/visual-system/scene-templates/comparison.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+function ComparisonScene(props) {
+  const { variables, width, height, progress, motionProgress = progress, safeZone } = props;
+  const overMedia = hasSceneMedia(variables);
+  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(EditorialSurface, { ...props, template: "comparison", 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), color: overMedia ? "#fff" : "#b7b7bc", 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-EMV5335S.js

@@ -0,0 +1,43 @@
+import {
+  EditorialSurface
+} from "./chunk-XX4GXKTX.js";
+import "./chunk-NMFDC2W2.js";
+import "./chunk-77VY4O7A.js";
+import {
+  fade
+} from "./chunk-4YM2M62S.js";
+import "./chunk-224QNWRA.js";
+import "./chunk-TVIU23OM.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(props) {
+  const { variables, progress, motionProgress = progress, width, height, safeZone } = props;
+  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(EditorialSurface, { ...props, template: "timeline", 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
+};