@vanillaskyai/video 0.8.8 → 0.9.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-LH4BPALA.js

@@ -0,0 +1,564 @@
+// src/visual-system/catalog/catalog.generated.ts
+var GENERATED_BUILTIN_TEMPLATE_CATALOG = [
+  {
+    "label": "Full-bleed",
+    "description": "Immersive photo or video without a headline.",
+    "usesGlobalTextEffect": false,
+    "usesGlobalTransition": false,
+    "usesGlobalBackgroundEffect": false,
+    "textCanvas": "tight",
+    "id": "cinemaMedia",
+    "family": "Media & motion",
+    "jobs": [
+      "setup",
+      "atmosphere",
+      "payoff"
+    ],
+    "register": "motion-led",
+    "useWhen": "Show a relevant place, activity or subject. The asset is resolved separately from a shot description. ",
+    "avoidWhen": "No relevant asset can be resolved or the scene needs structured explanation.",
+    "minDuration": 3,
+    "preferredDuration": 6,
+    "timing": {
+      "contentFields": [],
+      "contentUnit": "words",
+      "revealSeconds": 0,
+      "holdSeconds": 3,
+      "exitSeconds": 0
+    },
+    "schema": {
+      "type": "object",
+      "properties": {
+        "mediaKeyword": {
+          "type": "string",
+          "format": "stock-media-keyword",
+          "minLength": 1,
+          "maxLength": 80,
+          "description": "2\u20138 word literal subject/action search intent, maximum 80 characters. Host resolves URLs.",
+          "examples": [
+            "Ocean waves breaking on a rocky shore"
+          ]
+        },
+        "mediaUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "Host-only approved photo or video URL.",
+          "default": ""
+        },
+        "mediaType": {
+          "type": "string",
+          "enum": [
+            "photo",
+            "video"
+          ],
+          "default": "video",
+          "description": "Host-resolved asset kind."
+        },
+        "mediaPoster": {
+          "type": "string",
+          "format": "uri",
+          "description": "Host-only approved poster URL for video decoding.",
+          "default": ""
+        },
+        "shotDirection": {
+          "type": "string",
+          "maxLength": 220,
+          "description": "Optional action, framing and continuity for generation. Preserve the subject; do not request rendered text."
+        },
+        "mediaSource": {
+          "type": "string",
+          "enum": [
+            "generate",
+            "stock"
+          ],
+          "description": "Generate distinctive illustrative shots; use approved stock for familiar observable subjects."
+        },
+        "fallbackText": {
+          "type": "string",
+          "maxLength": 65,
+          "description": "Optional grounded concise chapter text if this shot cannot be resolved; not visible over footage."
+        }
+      },
+      "required": [],
+      "additionalProperties": false,
+      "x-vanillasky": {
+        "allowsStockMedia": true,
+        "requiredAnyOf": [
+          [
+            "mediaKeyword",
+            "mediaUrl"
+          ]
+        ]
+      }
+    }
+  },
+  {
+    "label": "Chapter",
+    "description": "Centered white typography fades in, holds, and fades out on black.",
+    "usesGlobalTextEffect": false,
+    "usesGlobalTransition": false,
+    "usesGlobalBackgroundEffect": false,
+    "textCanvas": "tight",
+    "id": "chapterTitle",
+    "family": "Explainers",
+    "jobs": [
+      "setup",
+      "payoff"
+    ],
+    "register": "motion-led",
+    "useWhen": "An opening, new chapter or deliberate short takeaway needs its own visual beat. ",
+    "avoidWhen": "A headline would merely repeat subtitles over an ordinary footage scene.",
+    "minDuration": 3,
+    "preferredDuration": 4,
+    "timing": {
+      "contentFields": [
+        "title"
+      ],
+      "contentUnit": "words",
+      "revealSeconds": 0.8,
+      "holdSeconds": 1.5,
+      "exitSeconds": 0.8
+    },
+    "schema": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string",
+          "maxLength": 65,
+          "description": "Short title. Line breaks optional.",
+          "default": "A different perspective"
+        }
+      },
+      "required": [
+        "title"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "label": "Focus cards",
+    "description": "Two to four short phrases fade in sequentially on black; no boxes or heading.",
+    "usesGlobalTextEffect": false,
+    "usesGlobalTransition": false,
+    "usesGlobalBackgroundEffect": false,
+    "textCanvas": "tight",
+    "id": "focusCards",
+    "family": "Explainers",
+    "jobs": [
+      "setup",
+      "proof"
+    ],
+    "register": "card-led",
+    "useWhen": "Two to four short parallel points support an explanation. ",
+    "avoidWhen": "The points require an order, long paragraphs, numerical data or additional images to make sense.",
+    "minDuration": 4,
+    "preferredDuration": 5,
+    "timing": {
+      "contentFields": [
+        "items"
+      ],
+      "contentUnit": "items",
+      "revealSeconds": 2.4,
+      "holdSeconds": 1.8,
+      "exitSeconds": 0
+    },
+    "schema": {
+      "type": "object",
+      "properties": {
+        "items": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 4,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 55
+          },
+          "default": [
+            "Listen closely",
+            "Notice the pattern",
+            "Make room for change"
+          ],
+          "description": "2\u20134 parallel phrases, about 2\u20136 words each; no heading or numbering."
+        }
+      },
+      "required": [
+        "items"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "label": "Timeline",
+    "description": "Three to five events on a fine continuous line on black; without dates.",
+    "usesGlobalTextEffect": false,
+    "usesGlobalTransition": false,
+    "usesGlobalBackgroundEffect": false,
+    "textCanvas": "tight",
+    "id": "editorialTimeline",
+    "family": "Explainers",
+    "jobs": [
+      "setup",
+      "proof"
+    ],
+    "register": "card-led",
+    "useWhen": "Events unfold in an order, or actions form a process. No dates or heading. ",
+    "avoidWhen": "The points are unordered or the story needs branching relationships.",
+    "minDuration": 5,
+    "preferredDuration": 6,
+    "timing": {
+      "contentFields": [
+        "events"
+      ],
+      "contentUnit": "items",
+      "revealSeconds": 3.2,
+      "holdSeconds": 1.8,
+      "exitSeconds": 0
+    },
+    "schema": {
+      "type": "object",
+      "properties": {
+        "events": {
+          "type": "array",
+          "minItems": 3,
+          "maxItems": 5,
+          "items": {
+            "type": "object",
+            "properties": {
+              "label": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 45
+              }
+            },
+            "required": [
+              "label"
+            ],
+            "additionalProperties": false
+          },
+          "default": [
+            {
+              "label": "Observe"
+            },
+            {
+              "label": "Understand"
+            },
+            {
+              "label": "Act"
+            }
+          ],
+          "description": "3\u20135 ordered events or actions, each with one short label; no dates."
+        }
+      },
+      "required": [
+        "events"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "label": "Reach out",
+    "description": "A frosted glass message over resolved media, without sender or timestamp.",
+    "usesGlobalTextEffect": false,
+    "usesGlobalTransition": false,
+    "usesGlobalBackgroundEffect": false,
+    "textCanvas": "tight",
+    "id": "mobileMessage",
+    "family": "Social & messaging",
+    "jobs": [
+      "setup"
+    ],
+    "register": "card-led",
+    "useWhen": "A person or organization reaches out with a short message, alert or invitation. Message must be supplied or explicitly illustrative.",
+    "avoidWhen": "The scene is a generic fact, a long exchange, or a message that would fabricate evidence.",
+    "minDuration": 4,
+    "preferredDuration": 6,
+    "timing": {
+      "contentFields": [
+        "message",
+        "app"
+      ],
+      "contentUnit": "words",
+      "revealSeconds": 1,
+      "holdSeconds": 2.2,
+      "exitSeconds": 0
+    },
+    "schema": {
+      "type": "object",
+      "properties": {
+        "mediaKeyword": {
+          "type": "string",
+          "format": "stock-media-keyword",
+          "minLength": 1,
+          "maxLength": 80,
+          "description": "2\u20138 word literal subject/action search intent, maximum 80 characters. Host resolves URLs.",
+          "examples": [
+            "Ocean waves breaking on a rocky shore"
+          ]
+        },
+        "mediaUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "Host-only approved photo or video URL.",
+          "default": ""
+        },
+        "mediaType": {
+          "type": "string",
+          "enum": [
+            "photo",
+            "video"
+          ],
+          "default": "video",
+          "description": "Host-resolved asset kind."
+        },
+        "mediaPoster": {
+          "type": "string",
+          "format": "uri",
+          "description": "Host-only approved poster URL for video decoding.",
+          "default": ""
+        },
+        "message": {
+          "type": "string",
+          "maxLength": 120,
+          "default": "Can we talk?",
+          "description": "Exact supplied or explicitly illustrative message, preferably 6\u201316 words."
+        },
+        "app": {
+          "type": "string",
+          "maxLength": 24,
+          "default": "Messages",
+          "description": "Optional app label; Messages is the visual default."
+        },
+        "shotDirection": {
+          "type": "string",
+          "maxLength": 220,
+          "description": "Optional action, framing and continuity for generation. Preserve the subject; do not request rendered text."
+        },
+        "mediaSource": {
+          "type": "string",
+          "enum": [
+            "generate",
+            "stock"
+          ],
+          "description": "Generate distinctive illustrative shots; use approved stock for familiar observable subjects."
+        }
+      },
+      "required": [
+        "message"
+      ],
+      "additionalProperties": false,
+      "x-vanillasky": {
+        "allowsStockMedia": true
+      }
+    }
+  },
+  {
+    "label": "Comparison",
+    "description": "Two short statements with equal weight on black, side by side or stacked in portrait.",
+    "usesGlobalTextEffect": false,
+    "usesGlobalTransition": false,
+    "usesGlobalBackgroundEffect": false,
+    "textCanvas": "tight",
+    "id": "comparison",
+    "family": "Explainers",
+    "jobs": [
+      "proof"
+    ],
+    "register": "motion-led",
+    "useWhen": "Explain a before/after change or two alternatives with short parallel statements. ",
+    "avoidWhen": "There are more than two alternatives or a numerical chart is needed.",
+    "minDuration": 4,
+    "preferredDuration": 6,
+    "timing": {
+      "contentFields": [
+        "leftText",
+        "rightText",
+        "leftLabel",
+        "rightLabel"
+      ],
+      "contentUnit": "words",
+      "revealSeconds": 1.2,
+      "holdSeconds": 2.5,
+      "exitSeconds": 0
+    },
+    "schema": {
+      "type": "object",
+      "properties": {
+        "leftLabel": {
+          "type": "string",
+          "maxLength": 20,
+          "description": "Optional short identifier for the first alternative."
+        },
+        "rightLabel": {
+          "type": "string",
+          "maxLength": 20,
+          "description": "Optional short identifier for the second alternative."
+        },
+        "leftText": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 60,
+          "default": "More distractions",
+          "description": "First real alternative in one short phrase."
+        },
+        "rightText": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 60,
+          "default": "More room to think",
+          "description": "Second real alternative, parallel to the first."
+        }
+      },
+      "required": [
+        "leftText",
+        "rightText"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "label": "Quote",
+    "description": "A short exact quotation with a legible attribution on black.",
+    "usesGlobalTextEffect": false,
+    "usesGlobalTransition": false,
+    "usesGlobalBackgroundEffect": false,
+    "textCanvas": "tight",
+    "id": "quote",
+    "family": "Explainers",
+    "jobs": [
+      "proof"
+    ],
+    "register": "motion-led",
+    "useWhen": "A supplied quotation deserves its own moment. Use exact source words and attribution only.",
+    "avoidWhen": "No exact quotation or reliable attribution is supplied; never invent testimony.",
+    "minDuration": 5,
+    "preferredDuration": 7,
+    "timing": {
+      "contentFields": [
+        "quote",
+        "attribution"
+      ],
+      "contentUnit": "words",
+      "revealSeconds": 1.2,
+      "holdSeconds": 3,
+      "exitSeconds": 0
+    },
+    "schema": {
+      "type": "object",
+      "properties": {
+        "quote": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 140,
+          "format": "grounded-quote",
+          "examples": [
+            "Look closely. There is always more to see."
+          ],
+          "description": "Exact supplied quotation; do not paraphrase or invent."
+        },
+        "attribution": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 60,
+          "examples": [
+            "Illustrative example"
+          ],
+          "description": "Grounded attribution belonging to these exact quoted words."
+        }
+      },
+      "required": [
+        "quote",
+        "attribution"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "label": "Key figure",
+    "description": "One supplied figure with one short label on black.",
+    "usesGlobalTextEffect": false,
+    "usesGlobalTransition": false,
+    "usesGlobalBackgroundEffect": false,
+    "textCanvas": "tight",
+    "id": "keyFigure",
+    "family": "Explainers",
+    "jobs": [
+      "proof"
+    ],
+    "register": "motion-led",
+    "useWhen": "One verified quantity or supplied target anchors the explanation. Value, unit and context must match supplied evidence.",
+    "avoidWhen": "No reliable figure is supplied or multiple values require a chart.",
+    "minDuration": 4,
+    "preferredDuration": 5,
+    "timing": {
+      "contentFields": [
+        "value",
+        "label"
+      ],
+      "contentUnit": "words",
+      "revealSeconds": 0.8,
+      "holdSeconds": 2.5,
+      "exitSeconds": 0
+    },
+    "schema": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 14,
+          "format": "grounded-stat",
+          "examples": [
+            "42%"
+          ],
+          "description": "One supplied supported quantity, preserving its unit."
+        },
+        "label": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 50,
+          "examples": [
+            "Illustrative example"
+          ],
+          "description": "Exactly one short label identifying the quantity and its context."
+        }
+      },
+      "required": [
+        "value",
+        "label"
+      ],
+      "additionalProperties": false,
+      "x-vanillasky": {
+        "requiresStat": true
+      }
+    }
+  }
+];
+
+// src/visual-system/catalog/builtin-metadata.ts
+function freezeValue(value) {
+  if (value && typeof value === "object" && !Object.isFrozen(value)) {
+    for (const nested of Object.values(value)) freezeValue(nested);
+    Object.freeze(value);
+  }
+  return value;
+}
+var BUILTIN_TEMPLATE_CATALOG = freezeValue(
+  [...GENERATED_BUILTIN_TEMPLATE_CATALOG]
+);
+var metadataById = new Map(BUILTIN_TEMPLATE_CATALOG.map((template) => [template.id, template]));
+var BUILTIN_TEMPLATE_CAPABILITIES = freezeValue({
+  templates: BUILTIN_TEMPLATE_CATALOG.map(({ id }) => id).sort()
+});
+function listBuiltinTemplateMetadata() {
+  return BUILTIN_TEMPLATE_CATALOG;
+}
+function getBuiltinTemplateMetadata(id) {
+  return metadataById.get(id);
+}
+
+export {
+  BUILTIN_TEMPLATE_CATALOG,
+  listBuiltinTemplateMetadata,
+  getBuiltinTemplateMetadata
+};

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

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