@vanillaskyai/video 0.5.8 → 0.7.0

package/dist/{chunk-3RV4YKB3.js → chunk-JNN3EYVP.js}

@@ -79,8 +79,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -431,8 +432,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -487,7 +489,8 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
           "type": "string",
           "title": "Text",
           "description": "Title text shown above the chart",
-          "default": "Revenue up 300%."
+          "default": "Revenue up 300%.",
+          "maxLength": 48
         },
         "bars": {
           "type": "array",
@@ -600,8 +603,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -733,8 +737,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -911,8 +916,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -1102,8 +1108,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -1218,8 +1225,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -1282,7 +1290,7 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
           "description": "Command typed character by character. Keep the meaningful invocation within 80 characters; the terminal deliberately ellipsizes longer display lines.",
           "minLength": 1,
           "maxLength": 80,
-          "default": "npx vanillasky check"
+          "default": "npx vanillasky templates check"
         },
         "output": {
           "type": "array",
@@ -1359,8 +1367,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -1505,8 +1514,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -1629,8 +1639,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -1951,8 +1962,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -2125,8 +2137,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -2247,8 +2260,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -2373,8 +2387,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -2473,8 +2488,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -2575,8 +2591,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -2845,8 +2862,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -2975,8 +2993,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -3029,7 +3048,8 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
           "type": "string",
           "title": "Text",
           "description": "Title text",
-          "default": "What you get."
+          "default": "What you get.",
+          "maxLength": 48
         },
         "items": {
           "type": "array",
@@ -3112,8 +3132,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -3166,7 +3187,8 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
           "type": "string",
           "title": "Text",
           "description": "Title text",
-          "default": "How it works."
+          "default": "How it works.",
+          "maxLength": 48
         },
         "steps": {
           "type": "array",
@@ -3249,8 +3271,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -3361,8 +3384,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"
@@ -3482,8 +3506,9 @@ var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
         "mediaTreatment": {
           "type": "string",
           "title": "Background contrast treatment",
-          "description": "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+          "description": "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
           "enum": [
+            "none",
             "subtle",
             "cinematic",
             "text-safe"

package/dist/{chunk-NGY3TNND.js → chunk-K746NUIP.js}

@@ -1,10 +1,10 @@
-import {
-  ExternalVideoBackdropProvider
-} from "./chunk-C6WVCZRW.js";
 import {
   limitsConcurrentVideoDecoders,
   resolveMediaType
 } from "./chunk-224QNWRA.js";
+import {
+  ExternalVideoBackdropProvider
+} from "./chunk-5CDAM24P.js";
 import {
   resolveDensity
 } from "./chunk-XWWLKRNU.js";
@@ -47,7 +47,7 @@ function scaleSafeZone(zone, factor) {
 // src/player/video-frame.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
 var SCENE_TRANSITION_SECONDS = 0.3;
-var SceneVideoBackdrop = lazy(() => import("./scene-video-backdrop-IL4F2SVD.js").then((module) => ({ default: module.SceneVideoBackdrop })));
+var SceneVideoBackdrop = lazy(() => import("./scene-video-backdrop-XFPX4O3I.js").then((module) => ({ default: module.SceneVideoBackdrop })));
 var MEDIA_PREROLL_SECONDS = 1.2;
 var CONTIGUITY_ULP_FACTOR = 4;
 var subscribeToDecoderPolicy = () => () => {
@@ -110,6 +110,8 @@ function SceneLayer({
   width,
   height,
   playing,
+  mediaAudioMuted,
+  mediaAudioVolume,
   layer,
   opacity,
   interactive,
@@ -118,57 +120,65 @@ function SceneLayer({
 }) {
   const template = kit.getTemplate(range.scene.templateId);
   const duration = range.end - range.start;
-  return /* @__PURE__ */ jsx(ExternalVideoBackdropProvider, { mode: externalVideoBackdrop, children: /* @__PURE__ */ jsx(
-    "div",
+  return /* @__PURE__ */ jsx(
+    ExternalVideoBackdropProvider,
     {
-      "data-scene-layer": layer,
-      "data-layer-scene-id": range.scene.id,
-      "data-layer-template-id": range.scene.templateId,
-      "aria-hidden": interactive ? void 0 : true,
-      ...interactive ? {} : { inert: "inert" },
-      style: {
-        position: "absolute",
-        inset: 0,
-        opacity,
-        zIndex,
-        pointerEvents: interactive ? "auto" : "none",
-        // A changed-media transition can expose an incoming template's true
-        // initial frame. Values that would be false placeholders at progress
-        // zero opt into this inherited guard.
-        "--vanillasky-transition-semantic-visibility": layer === "incoming" ? "hidden" : "visible",
-        "--vanillasky-template-surface": externalVideoBackdrop !== false ? "transparent" : void 0
-      },
-      children: template ? /* @__PURE__ */ jsx(Suspense, { fallback: /* @__PURE__ */ jsx(
+      mode: externalVideoBackdrop,
+      audioMuted: mediaAudioMuted || !playing,
+      audioVolume: mediaAudioVolume,
+      children: /* @__PURE__ */ jsx(
         "div",
         {
-          "data-template-loading": range.scene.templateId,
-          style: { position: "absolute", inset: 0 }
+          "data-scene-layer": layer,
+          "data-layer-scene-id": range.scene.id,
+          "data-layer-template-id": range.scene.templateId,
+          "aria-hidden": interactive ? void 0 : true,
+          ...interactive ? {} : { inert: "inert" },
+          style: {
+            position: "absolute",
+            inset: 0,
+            opacity,
+            zIndex,
+            pointerEvents: interactive ? "auto" : "none",
+            // A changed-media transition can expose an incoming template's true
+            // initial frame. Values that would be false placeholders at progress
+            // zero opt into this inherited guard.
+            "--vanillasky-transition-semantic-visibility": layer === "incoming" ? "hidden" : "visible",
+            "--vanillasky-template-surface": externalVideoBackdrop !== false ? "transparent" : void 0
+          },
+          children: template ? /* @__PURE__ */ jsx(Suspense, { fallback: /* @__PURE__ */ jsx(
+            "div",
+            {
+              "data-template-loading": range.scene.templateId,
+              style: { position: "absolute", inset: 0 }
+            }
+          ), children: createElement(template.component, {
+            variables: {
+              ...template.defaults ?? getTemplateDefaults(template.schema),
+              ...range.scene.variables
+            },
+            style: config.style,
+            progress,
+            motionProgress,
+            beatIntensity: 0,
+            width,
+            height,
+            textArchetype: range.scene.textArchetype ?? config.style.defaultTextArchetype,
+            backgroundEffect: range.scene.backgroundEffect ?? config.style.defaultBackgroundEffect,
+            safeZone: scaleSafeZone(
+              getSafeZone(config.orientation),
+              resolveDensity(config.style.density).safeZoneScale
+            ),
+            sceneDuration: duration,
+            isPlaying: playing
+          }) }) : /* @__PURE__ */ jsxs("div", { style: { width, height, background: "#090712", color: "#fff" }, children: [
+            "Unsupported template: ",
+            range.scene.templateId
+          ] })
         }
-      ), children: createElement(template.component, {
-        variables: {
-          ...template.defaults ?? getTemplateDefaults(template.schema),
-          ...range.scene.variables
-        },
-        style: config.style,
-        progress,
-        motionProgress,
-        beatIntensity: 0,
-        width,
-        height,
-        textArchetype: range.scene.textArchetype ?? config.style.defaultTextArchetype,
-        backgroundEffect: range.scene.backgroundEffect ?? config.style.defaultBackgroundEffect,
-        safeZone: scaleSafeZone(
-          getSafeZone(config.orientation),
-          resolveDensity(config.style.density).safeZoneScale
-        ),
-        sceneDuration: duration,
-        isPlaying: playing
-      }) }) : /* @__PURE__ */ jsxs("div", { style: { width, height, background: "#090712", color: "#fff" }, children: [
-        "Unsupported template: ",
-        range.scene.templateId
-      ] })
+      )
     }
-  ) });
+  );
 }
 function VideoFrame({
   kit,
@@ -177,6 +187,8 @@ function VideoFrame({
   width,
   height,
   playing = false,
+  mediaAudioMuted = true,
+  mediaAudioVolume = 1,
   className,
   style
 }) {
@@ -351,6 +363,8 @@ function VideoFrame({
                     backgroundEffect: persistentVideoRange.scene.backgroundEffect ?? config.style.defaultBackgroundEffect,
                     progress: persistentVideoRange.scene.id === active.scene.id ? rawProgress : 0,
                     isPlaying: persistentVideoRange.scene.id === active.scene.id && playing,
+                    muted: mediaAudioMuted || persistentVideoRange.scene.id !== active.scene.id || !playing,
+                    volume: mediaAudioVolume,
                     playbackId: persistentVideoRange.scene.id,
                     retainPoster: true,
                     persistent: true,
@@ -380,6 +394,8 @@ function VideoFrame({
                   width: canvas.width,
                   height: canvas.height,
                   playing,
+                  mediaAudioMuted,
+                  mediaAudioVolume,
                   layer: previewingNext ? "outgoing" : "active",
                   opacity: 1 - blendProgress,
                   interactive: true,
@@ -399,6 +415,8 @@ function VideoFrame({
                   width: canvas.width,
                   height: canvas.height,
                   playing: false,
+                  mediaAudioMuted,
+                  mediaAudioVolume,
                   layer: "incoming",
                   opacity: blendProgress,
                   interactive: false,
@@ -419,6 +437,8 @@ function VideoFrame({
                   width: canvas.width,
                   height: canvas.height,
                   playing,
+                  mediaAudioMuted,
+                  mediaAudioVolume,
                   layer: "active",
                   opacity: 1,
                   interactive: true,

package/dist/{chunk-HVCPEAQF.js → chunk-LKBZX7GV.js}

@@ -40,8 +40,8 @@ function createBackgroundMediaSchemaProperties(options = {}) {
     mediaTreatment: {
       type: "string",
       title: "Background contrast treatment",
-      description: "subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
-      enum: ["subtle", "cinematic", "text-safe"],
+      description: "none leaves the picture untouched, for a scene carrying no type; subtle preserves a visual hero; cinematic adds balanced contrast; text-safe adds a stronger wash for copy-heavy scenes.",
+      enum: ["none", "subtle", "cinematic", "text-safe"],
       default: "cinematic"
     }
   };
@@ -254,7 +254,8 @@ var BUILTIN_TEMPLATE_SCHEMAS = {
         "type": "string",
         "title": "Text",
         "description": "Title text shown above the chart",
-        "default": "Revenue up 300%."
+        "default": "Revenue up 300%.",
+        "maxLength": 48
       },
       "bars": {
         "type": "array",
@@ -603,7 +604,7 @@ var BUILTIN_TEMPLATE_SCHEMAS = {
         "description": "Command typed character by character. Keep the meaningful invocation within 80 characters; the terminal deliberately ellipsizes longer display lines.",
         "minLength": 1,
         "maxLength": 80,
-        "default": "npx vanillasky check"
+        "default": "npx vanillasky templates check"
       },
       "output": {
         "type": "array",
@@ -1346,7 +1347,8 @@ var BUILTIN_TEMPLATE_SCHEMAS = {
         "type": "string",
         "title": "Text",
         "description": "Title text",
-        "default": "What you get."
+        "default": "What you get.",
+        "maxLength": 48
       },
       "items": {
         "type": "array",
@@ -1398,7 +1400,8 @@ var BUILTIN_TEMPLATE_SCHEMAS = {
         "type": "string",
         "title": "Text",
         "description": "Title text",
-        "default": "How it works."
+        "default": "How it works.",
+        "maxLength": 48
       },
       "steps": {
         "type": "array",

package/dist/{chunk-G66Z5CWR.js → chunk-MMUXVA47.js}

@@ -11,11 +11,13 @@ var VIDEO_WARNING_CATEGORIES = {
   scene_duration_adjusted: "readability",
   scene_omitted_unreadable: "readability",
   scene_omitted_for_closer: "readability",
+  scene_variable_clipped: "readability",
   chart_scale_imbalance: "readability",
   plan_incomplete: "provider",
   plan_missing_closer: "provider",
   provider_warning: "provider",
-  provider_diagnostics_unavailable: "provider"
+  provider_diagnostics_unavailable: "provider",
+  media_budget_reached: "media"
 };
 var MAX_PUBLIC_DIAGNOSTIC_LENGTH = 160;
 var SECRET_ASSIGNMENT = /\b(?:api[_-]?key|authorization|secret|token|password)\s*[:=]\s*\S+/gi;
@@ -32,6 +34,22 @@ function safePublicDiagnostic(value, fallback) {
   if (redacted.length <= MAX_PUBLIC_DIAGNOSTIC_LENGTH) return redacted;
   return `${redacted.slice(0, MAX_PUBLIC_DIAGNOSTIC_LENGTH - 1).trimEnd()}\u2026`;
 }
+function createClippedVariableWarning(templateId, fields) {
+  return {
+    code: "scene_variable_clipped",
+    category: VIDEO_WARNING_CATEGORIES.scene_variable_clipped,
+    message: `Trimmed ${fields.join(", ")} on ${templateId} to the length the template declares.`,
+    recoverable: true
+  };
+}
+function createMediaBudgetWarning(limit) {
+  return {
+    code: "media_budget_reached",
+    category: VIDEO_WARNING_CATEGORIES.media_budget_reached,
+    message: `Resolved media for ${limit} scene${limit === 1 ? "" : "s"}; later scenes keep their copy on the brand gradient.`,
+    recoverable: true
+  };
+}
 
 // src/protocol/json-validation.ts
 var DANGEROUS_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
@@ -125,7 +143,8 @@ function scene(value, path) {
     "variables",
     "textArchetype",
     "backgroundEffect",
-    "timing"
+    "timing",
+    "narration"
   ], path);
   string(result.id, `${path}.id`);
   string(result.templateId, `${path}.templateId`);
@@ -134,6 +153,7 @@ function scene(value, path) {
   timing(result.timing, `${path}.timing`);
   if (result.textArchetype != null) string(result.textArchetype, `${path}.textArchetype`);
   if (result.backgroundEffect != null) string(result.backgroundEffect, `${path}.backgroundEffect`);
+  if (result.narration != null) string(result.narration, `${path}.narration`);
   return result;
 }
 function capabilities(value, path) {
@@ -161,9 +181,11 @@ function style(value, path) {
     "defaultTextArchetype",
     "defaultTransition",
     "density",
-    "motion"
+    "motion",
+    "generatedLook"
   ], path);
   validateVideoBrand(result.brand, `${path}.brand`);
+  if (result.generatedLook != null) string(result.generatedLook, `${path}.generatedLook`);
   return result;
 }
 function audio(value, path) {
@@ -338,6 +360,8 @@ function parseVideoPlanPart(value) {
 
 export {
   safePublicDiagnostic,
+  createClippedVariableWarning,
+  createMediaBudgetWarning,
   record,
   allowedKeys,
   string,

package/dist/{chunk-6M6DATLW.js → chunk-MXZSDGZQ.js}

@@ -1,23 +1,23 @@
 import {
   SceneVideoBackdrop,
   resolveMediaPosition
-} from "./chunk-HT6BGERF.js";
+} from "./chunk-FRN6WKHA.js";
 import {
   BrandGradientOverlay,
   getBackgroundTransform
 } from "./chunk-W3VDIBGR.js";
-import {
-  useExternalVideoBackdrop
-} from "./chunk-C6WVCZRW.js";
 import {
   resolveMediaType
 } from "./chunk-224QNWRA.js";
+import {
+  useExternalVideoBackdrop
+} from "./chunk-5CDAM24P.js";
 
 // src/visual-system/scene-templates/scene-background.tsx
 import { useEffect, useState } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 function resolveMediaTreatment(value) {
-  return value === "subtle" || value === "text-safe" ? value : "cinematic";
+  return value === "none" || value === "subtle" || value === "text-safe" ? value : "cinematic";
 }
 var SCRIM_STOP_COUNT = 7;
 function smoothstep(t) {
@@ -40,6 +40,7 @@ function easedStops(peakAlpha, start, end, direction) {
 }
 function getMediaTreatmentLayers(value, anchor = "full") {
   const treatment = resolveMediaTreatment(value);
+  if (treatment === "none") return [];
   const vignette = {
     id: "vignette",
     background: treatment === "subtle" ? `radial-gradient(ellipse at center, ${easedStops(0.28, 45, 100, "fade-in")})` : `radial-gradient(ellipse at center, ${easedStops(0.72, 32, 100, "fade-in")})`