@contractspec/lib.video-gen 1.44.0 → 1.46.0

package/dist/browser/index.js

@@ -1120,17 +1120,528 @@ var TerminalDemo = ({
     ]
   }, undefined, true, undefined, this);
 };
+// src/i18n/catalogs/en.ts
+import { defineTranslation } from "@contractspec/lib.contracts-spec/translations";
+var enMessages = defineTranslation({
+  meta: {
+    key: "video-gen.messages",
+    version: "1.0.0",
+    domain: "video-gen",
+    description: "All user-facing, LLM-facing, and developer-facing strings for the video-gen package",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "en",
+  fallback: "en",
+  messages: {
+    "prompt.script.system": {
+      value: `You are a video narration script writer.
+Write a narration script for a short video (30-60 seconds).
+{styleGuide}
+
+Return JSON with shape:
+{
+  "segments": [{ "sceneId": string, "text": string }],
+  "fullText": string
+}
+
+Scene IDs should be: "intro", "problems", "solutions", "metrics", "cta".
+Only include segments that are relevant to the brief content.`,
+      description: "Script generator LLM system prompt",
+      placeholders: [{ name: "styleGuide", type: "string" }]
+    },
+    "prompt.scenePlanner.system": {
+      value: `You are a video scene planner for ContractSpec marketing/documentation videos.
+Given a content brief, break it into video scenes.
+
+Each scene must have:
+- compositionId: one of "ApiOverview", "SocialClip", "TerminalDemo"
+- props: the input props for that composition (see type definitions)
+- durationInFrames: duration at {fps}fps
+- narrationText: what the narrator says during this scene
+
+Return a JSON object with shape:
+{
+  "scenes": [{ "compositionId": string, "props": object, "durationInFrames": number, "narrationText": string }],
+  "narrationScript": string
+}
+
+Keep the total duration around {targetSeconds} seconds.
+Prioritize clarity and pacing. Each scene should communicate one idea.`,
+      description: "Scene planner LLM system prompt",
+      placeholders: [
+        { name: "fps", type: "number" },
+        { name: "targetSeconds", type: "number" }
+      ]
+    },
+    "prompt.style.professional": {
+      value: "Use a clear, authoritative, professional tone. Be concise and direct.",
+      description: "Style guide for professional narration"
+    },
+    "prompt.style.casual": {
+      value: "Use a friendly, conversational tone. Be approachable and relatable.",
+      description: "Style guide for casual narration"
+    },
+    "prompt.style.technical": {
+      value: "Use precise technical language. Be detailed and accurate.",
+      description: "Style guide for technical narration"
+    },
+    "script.segment.challenge": {
+      value: "The challenge: {content}",
+      description: "Narration segment prefix for problems",
+      placeholders: [{ name: "content", type: "string" }]
+    },
+    "script.segment.solution": {
+      value: "The solution: {content}",
+      description: "Narration segment prefix for solutions",
+      placeholders: [{ name: "content", type: "string" }]
+    },
+    "script.segment.results": {
+      value: "The results: {content}",
+      description: "Narration segment prefix for metrics",
+      placeholders: [{ name: "content", type: "string" }]
+    },
+    "scene.cta.default": {
+      value: "Learn more",
+      description: "Default call-to-action text for scenes"
+    },
+    "scene.hook.problem": {
+      value: "The Problem",
+      description: "Scene hook label for problem statement"
+    },
+    "scene.narration.problem": {
+      value: "The problem: {content}",
+      description: "Scene narration for problem statement",
+      placeholders: [{ name: "content", type: "string" }]
+    },
+    "scene.hook.solution": {
+      value: "The Solution",
+      description: "Scene hook label for solution"
+    },
+    "scene.narration.solution": {
+      value: "The solution: {content}",
+      description: "Scene narration for solution",
+      placeholders: [{ name: "content", type: "string" }]
+    },
+    "scene.hook.results": {
+      value: "Results",
+      description: "Scene hook label for results/metrics"
+    },
+    "composition.apiOverview.generates": {
+      value: "Generates:",
+      description: "ApiOverview heading for generated outputs"
+    },
+    "composition.apiOverview.tagline": {
+      value: "One spec. Every surface.",
+      description: "ApiOverview default tagline"
+    },
+    "composition.apiOverview.output.rest": {
+      value: "REST Endpoint",
+      description: "Generated output label: REST"
+    },
+    "composition.apiOverview.output.graphql": {
+      value: "GraphQL Mutation",
+      description: "Generated output label: GraphQL"
+    },
+    "composition.apiOverview.output.prisma": {
+      value: "Prisma Model",
+      description: "Generated output label: Prisma"
+    },
+    "composition.apiOverview.output.typescript": {
+      value: "TypeScript SDK",
+      description: "Generated output label: TypeScript SDK"
+    },
+    "composition.apiOverview.output.mcp": {
+      value: "MCP Tool",
+      description: "Generated output label: MCP Tool"
+    },
+    "composition.apiOverview.output.openapi": {
+      value: "OpenAPI Spec",
+      description: "Generated output label: OpenAPI"
+    },
+    "composition.socialClip.cta": {
+      value: "Learn more",
+      description: "SocialClip default CTA"
+    },
+    "composition.terminal.title": {
+      value: "Terminal",
+      description: "TerminalDemo default window title"
+    }
+  }
+});
+
+// src/i18n/catalogs/fr.ts
+import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations";
+var frMessages = defineTranslation2({
+  meta: {
+    key: "video-gen.messages",
+    version: "1.0.0",
+    domain: "video-gen",
+    description: "French translations for the video-gen package",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "fr",
+  fallback: "en",
+  messages: {
+    "prompt.script.system": {
+      value: `Vous êtes un rédacteur de scripts de narration vidéo.
+Écrivez un script de narration pour une courte vidéo (30-60 secondes).
+{styleGuide}
+
+Retournez du JSON avec la forme :
+{
+  "segments": [{ "sceneId": string, "text": string }],
+  "fullText": string
+}
+
+Les identifiants de scène doivent être : "intro", "problems", "solutions", "metrics", "cta".
+N'incluez que les segments pertinents au brief.`,
+      description: "Script generator LLM system prompt",
+      placeholders: [{ name: "styleGuide", type: "string" }]
+    },
+    "prompt.scenePlanner.system": {
+      value: `Vous êtes un planificateur de scènes vidéo pour les vidéos marketing/documentation de ContractSpec.
+À partir d'un brief, décomposez-le en scènes vidéo.
+
+Chaque scène doit avoir :
+- compositionId : un parmi "ApiOverview", "SocialClip", "TerminalDemo"
+- props : les propriétés d'entrée de cette composition
+- durationInFrames : durée à {fps} fps
+- narrationText : ce que le narrateur dit pendant cette scène
+
+Retournez un objet JSON avec la forme :
+{
+  "scenes": [{ "compositionId": string, "props": object, "durationInFrames": number, "narrationText": string }],
+  "narrationScript": string
+}
+
+Gardez la durée totale autour de {targetSeconds} secondes.
+Privilégiez la clarté et le rythme. Chaque scène doit communiquer une idée.`,
+      description: "Scene planner LLM system prompt",
+      placeholders: [
+        { name: "fps", type: "number" },
+        { name: "targetSeconds", type: "number" }
+      ]
+    },
+    "prompt.style.professional": {
+      value: "Utilisez un ton clair, autoritaire et professionnel. Soyez concis et direct.",
+      description: "Style guide for professional narration"
+    },
+    "prompt.style.casual": {
+      value: "Utilisez un ton amical et conversationnel. Soyez accessible et proche.",
+      description: "Style guide for casual narration"
+    },
+    "prompt.style.technical": {
+      value: "Utilisez un langage technique précis. Soyez détaillé et exact.",
+      description: "Style guide for technical narration"
+    },
+    "script.segment.challenge": {
+      value: "Le défi : {content}",
+      description: "Narration segment prefix for problems",
+      placeholders: [{ name: "content", type: "string" }]
+    },
+    "script.segment.solution": {
+      value: "La solution : {content}",
+      description: "Narration segment prefix for solutions",
+      placeholders: [{ name: "content", type: "string" }]
+    },
+    "script.segment.results": {
+      value: "Les résultats : {content}",
+      description: "Narration segment prefix for metrics",
+      placeholders: [{ name: "content", type: "string" }]
+    },
+    "scene.cta.default": {
+      value: "En savoir plus",
+      description: "Default call-to-action text for scenes"
+    },
+    "scene.hook.problem": {
+      value: "Le problème",
+      description: "Scene hook label for problem statement"
+    },
+    "scene.narration.problem": {
+      value: "Le problème : {content}",
+      description: "Scene narration for problem statement",
+      placeholders: [{ name: "content", type: "string" }]
+    },
+    "scene.hook.solution": {
+      value: "La solution",
+      description: "Scene hook label for solution"
+    },
+    "scene.narration.solution": {
+      value: "La solution : {content}",
+      description: "Scene narration for solution",
+      placeholders: [{ name: "content", type: "string" }]
+    },
+    "scene.hook.results": {
+      value: "Résultats",
+      description: "Scene hook label for results/metrics"
+    },
+    "composition.apiOverview.generates": {
+      value: "Génère :",
+      description: "ApiOverview heading for generated outputs"
+    },
+    "composition.apiOverview.tagline": {
+      value: "Un spec. Toutes les surfaces.",
+      description: "ApiOverview default tagline"
+    },
+    "composition.apiOverview.output.rest": {
+      value: "Endpoint REST",
+      description: "Generated output label: REST"
+    },
+    "composition.apiOverview.output.graphql": {
+      value: "Mutation GraphQL",
+      description: "Generated output label: GraphQL"
+    },
+    "composition.apiOverview.output.prisma": {
+      value: "Modèle Prisma",
+      description: "Generated output label: Prisma"
+    },
+    "composition.apiOverview.output.typescript": {
+      value: "SDK TypeScript",
+      description: "Generated output label: TypeScript SDK"
+    },
+    "composition.apiOverview.output.mcp": {
+      value: "Outil MCP",
+      description: "Generated output label: MCP Tool"
+    },
+    "composition.apiOverview.output.openapi": {
+      value: "Spec OpenAPI",
+      description: "Generated output label: OpenAPI"
+    },
+    "composition.socialClip.cta": {
+      value: "En savoir plus",
+      description: "SocialClip default CTA"
+    },
+    "composition.terminal.title": {
+      value: "Terminal",
+      description: "TerminalDemo default window title"
+    }
+  }
+});
+
+// src/i18n/catalogs/es.ts
+import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations";
+var esMessages = defineTranslation3({
+  meta: {
+    key: "video-gen.messages",
+    version: "1.0.0",
+    domain: "video-gen",
+    description: "Spanish translations for the video-gen package",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "es",
+  fallback: "en",
+  messages: {
+    "prompt.script.system": {
+      value: `Eres un redactor de guiones de narración para vídeo.
+Escribe un guión de narración para un vídeo corto (30-60 segundos).
+{styleGuide}
+
+Devuelve JSON con la forma:
+{
+  "segments": [{ "sceneId": string, "text": string }],
+  "fullText": string
+}
+
+Los identificadores de escena deben ser: "intro", "problems", "solutions", "metrics", "cta".
+Incluye solo los segmentos relevantes para el brief.`,
+      description: "Script generator LLM system prompt",
+      placeholders: [{ name: "styleGuide", type: "string" }]
+    },
+    "prompt.scenePlanner.system": {
+      value: `Eres un planificador de escenas de vídeo para vídeos de marketing/documentación de ContractSpec.
+Dado un brief de contenido, divídelo en escenas de vídeo.
+
+Cada escena debe tener:
+- compositionId: uno de "ApiOverview", "SocialClip", "TerminalDemo"
+- props: las propiedades de entrada de esa composición
+- durationInFrames: duración a {fps} fps
+- narrationText: lo que dice el narrador durante esta escena
+
+Devuelve un objeto JSON con la forma:
+{
+  "scenes": [{ "compositionId": string, "props": object, "durationInFrames": number, "narrationText": string }],
+  "narrationScript": string
+}
+
+Mantén la duración total alrededor de {targetSeconds} segundos.
+Prioriza la claridad y el ritmo. Cada escena debe comunicar una idea.`,
+      description: "Scene planner LLM system prompt",
+      placeholders: [
+        { name: "fps", type: "number" },
+        { name: "targetSeconds", type: "number" }
+      ]
+    },
+    "prompt.style.professional": {
+      value: "Usa un tono claro, autoritario y profesional. Sé conciso y directo.",
+      description: "Style guide for professional narration"
+    },
+    "prompt.style.casual": {
+      value: "Usa un tono amigable y conversacional. Sé accesible y cercano.",
+      description: "Style guide for casual narration"
+    },
+    "prompt.style.technical": {
+      value: "Usa un lenguaje técnico preciso. Sé detallado y exacto.",
+      description: "Style guide for technical narration"
+    },
+    "script.segment.challenge": {
+      value: "El desafío: {content}",
+      description: "Narration segment prefix for problems",
+      placeholders: [{ name: "content", type: "string" }]
+    },
+    "script.segment.solution": {
+      value: "La solución: {content}",
+      description: "Narration segment prefix for solutions",
+      placeholders: [{ name: "content", type: "string" }]
+    },
+    "script.segment.results": {
+      value: "Los resultados: {content}",
+      description: "Narration segment prefix for metrics",
+      placeholders: [{ name: "content", type: "string" }]
+    },
+    "scene.cta.default": {
+      value: "Más información",
+      description: "Default call-to-action text for scenes"
+    },
+    "scene.hook.problem": {
+      value: "El problema",
+      description: "Scene hook label for problem statement"
+    },
+    "scene.narration.problem": {
+      value: "El problema: {content}",
+      description: "Scene narration for problem statement",
+      placeholders: [{ name: "content", type: "string" }]
+    },
+    "scene.hook.solution": {
+      value: "La solución",
+      description: "Scene hook label for solution"
+    },
+    "scene.narration.solution": {
+      value: "La solución: {content}",
+      description: "Scene narration for solution",
+      placeholders: [{ name: "content", type: "string" }]
+    },
+    "scene.hook.results": {
+      value: "Resultados",
+      description: "Scene hook label for results/metrics"
+    },
+    "composition.apiOverview.generates": {
+      value: "Genera:",
+      description: "ApiOverview heading for generated outputs"
+    },
+    "composition.apiOverview.tagline": {
+      value: "Una spec. Todas las superficies.",
+      description: "ApiOverview default tagline"
+    },
+    "composition.apiOverview.output.rest": {
+      value: "Endpoint REST",
+      description: "Generated output label: REST"
+    },
+    "composition.apiOverview.output.graphql": {
+      value: "Mutación GraphQL",
+      description: "Generated output label: GraphQL"
+    },
+    "composition.apiOverview.output.prisma": {
+      value: "Modelo Prisma",
+      description: "Generated output label: Prisma"
+    },
+    "composition.apiOverview.output.typescript": {
+      value: "SDK TypeScript",
+      description: "Generated output label: TypeScript SDK"
+    },
+    "composition.apiOverview.output.mcp": {
+      value: "Herramienta MCP",
+      description: "Generated output label: MCP Tool"
+    },
+    "composition.apiOverview.output.openapi": {
+      value: "Spec OpenAPI",
+      description: "Generated output label: OpenAPI"
+    },
+    "composition.socialClip.cta": {
+      value: "Más información",
+      description: "SocialClip default CTA"
+    },
+    "composition.terminal.title": {
+      value: "Terminal",
+      description: "TerminalDemo default window title"
+    }
+  }
+});
+
+// src/i18n/messages.ts
+import {
+  createI18nFactory
+} from "@contractspec/lib.contracts-spec/translations";
+var factory = createI18nFactory({
+  specKey: "video-gen.messages",
+  catalogs: [enMessages, frMessages, esMessages]
+});
+var createVideoGenI18n = factory.create;
+var getDefaultI18n = factory.getDefault;
+var resetI18nRegistry = factory.resetRegistry;
+
+// src/i18n/locale.ts
+import {
+  DEFAULT_LOCALE,
+  SUPPORTED_LOCALES,
+  resolveLocale,
+  isSupportedLocale
+} from "@contractspec/lib.contracts-spec/translations";
+
+// src/i18n/keys.ts
+var PROMPT_KEYS = {
+  "prompt.script.system": "prompt.script.system",
+  "prompt.scenePlanner.system": "prompt.scenePlanner.system",
+  "prompt.style.professional": "prompt.style.professional",
+  "prompt.style.casual": "prompt.style.casual",
+  "prompt.style.technical": "prompt.style.technical"
+};
+var SCRIPT_KEYS = {
+  "script.segment.challenge": "script.segment.challenge",
+  "script.segment.solution": "script.segment.solution",
+  "script.segment.results": "script.segment.results"
+};
+var SCENE_KEYS = {
+  "scene.cta.default": "scene.cta.default",
+  "scene.hook.problem": "scene.hook.problem",
+  "scene.narration.problem": "scene.narration.problem",
+  "scene.hook.solution": "scene.hook.solution",
+  "scene.narration.solution": "scene.narration.solution",
+  "scene.hook.results": "scene.hook.results"
+};
+var COMPOSITION_KEYS = {
+  "composition.apiOverview.generates": "composition.apiOverview.generates",
+  "composition.apiOverview.tagline": "composition.apiOverview.tagline",
+  "composition.apiOverview.output.rest": "composition.apiOverview.output.rest",
+  "composition.apiOverview.output.graphql": "composition.apiOverview.output.graphql",
+  "composition.apiOverview.output.prisma": "composition.apiOverview.output.prisma",
+  "composition.apiOverview.output.typescript": "composition.apiOverview.output.typescript",
+  "composition.apiOverview.output.mcp": "composition.apiOverview.output.mcp",
+  "composition.apiOverview.output.openapi": "composition.apiOverview.output.openapi",
+  "composition.socialClip.cta": "composition.socialClip.cta",
+  "composition.terminal.title": "composition.terminal.title"
+};
+var I18N_KEYS = {
+  ...PROMPT_KEYS,
+  ...SCRIPT_KEYS,
+  ...SCENE_KEYS,
+  ...COMPOSITION_KEYS
+};
 // src/generators/scene-planner.ts
 class ScenePlanner {
   llm;
   model;
   temperature;
   fps;
+  i18n;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.3;
     this.fps = options?.fps ?? DEFAULT_FPS;
+    this.i18n = createVideoGenI18n(options?.locale);
   }
   async plan(brief) {
     if (this.llm) {
@@ -1140,6 +1651,7 @@ class ScenePlanner {
   }
   planDeterministic(brief) {
     const { content } = brief;
+    const { t } = this.i18n;
     const scenes = [];
     const fps = this.fps;
     scenes.push({
@@ -1148,7 +1660,7 @@ class ScenePlanner {
         hook: content.title,
         message: content.summary,
         points: content.solutions.slice(0, 3),
-        cta: content.callToAction ?? "Learn more"
+        cta: content.callToAction ?? t("scene.cta.default")
       },
       durationInFrames: 3 * fps,
       narrationText: `${content.title}. ${content.summary}`
@@ -1157,31 +1669,35 @@ class ScenePlanner {
       scenes.push({
         compositionId: "SocialClip",
         props: {
-          hook: "The Problem",
+          hook: t("scene.hook.problem"),
           message: content.problems[0] ?? "",
           points: content.problems.slice(1, 4)
         },
         durationInFrames: 4 * fps,
-        narrationText: `The problem: ${content.problems.join(". ")}`
+        narrationText: t("scene.narration.problem", {
+          content: content.problems.join(". ")
+        })
       });
     }
     if (content.solutions.length > 0) {
       scenes.push({
         compositionId: "SocialClip",
         props: {
-          hook: "The Solution",
+          hook: t("scene.hook.solution"),
           message: content.solutions[0] ?? "",
           points: content.solutions.slice(1, 4)
         },
         durationInFrames: 5 * fps,
-        narrationText: `The solution: ${content.solutions.join(". ")}`
+        narrationText: t("scene.narration.solution", {
+          content: content.solutions.join(". ")
+        })
       });
     }
     if (content.metrics && content.metrics.length > 0) {
       scenes.push({
         compositionId: "SocialClip",
         props: {
-          hook: "Results",
+          hook: t("scene.hook.results"),
           message: content.metrics[0] ?? "",
           points: content.metrics.slice(1, 3)
         },
@@ -1218,29 +1734,17 @@ class ScenePlanner {
     };
   }
   async planWithLlm(brief) {
+    const { t } = this.i18n;
     const messages = [
       {
         role: "system",
         content: [
           {
             type: "text",
-            text: `You are a video scene planner for ContractSpec marketing/documentation videos.
-Given a content brief, break it into video scenes.
-
-Each scene must have:
-- compositionId: one of "ApiOverview", "SocialClip", "TerminalDemo"
-- props: the input props for that composition (see type definitions)
-- durationInFrames: duration at ${this.fps}fps
-- narrationText: what the narrator says during this scene
-
-Return a JSON object with shape:
-{
-  "scenes": [{ "compositionId": string, "props": object, "durationInFrames": number, "narrationText": string }],
-  "narrationScript": string
-}
-
-Keep the total duration around ${brief.targetDurationSeconds ?? 30} seconds.
-Prioritize clarity and pacing. Each scene should communicate one idea.`
+            text: t("prompt.scenePlanner.system", {
+              fps: this.fps,
+              targetSeconds: brief.targetDurationSeconds ?? 30
+            })
           }
         ]
       },
@@ -1280,190 +1784,29 @@ Prioritize clarity and pacing. Each scene should communicate one idea.`
   }
 }
 
-// src/generators/script-generator.ts
-class ScriptGenerator {
-  llm;
-  model;
-  temperature;
-  constructor(options) {
-    this.llm = options?.llm;
-    this.model = options?.model;
-    this.temperature = options?.temperature ?? 0.5;
-  }
-  async generate(brief, config) {
-    const style = config?.style ?? "professional";
-    if (this.llm) {
-      return this.generateWithLlm(brief, style);
-    }
-    return this.generateDeterministic(brief, style);
-  }
-  generateDeterministic(brief, style) {
-    const segments = [];
-    const intro = this.formatForStyle(`${brief.title}. ${brief.summary}`, style);
-    segments.push({
-      sceneId: "intro",
-      text: intro,
-      estimatedDurationSeconds: this.estimateDuration(intro)
-    });
-    if (brief.problems.length > 0) {
-      const problemText = this.formatForStyle(`The challenge: ${brief.problems.join(". ")}`, style);
-      segments.push({
-        sceneId: "problems",
-        text: problemText,
-        estimatedDurationSeconds: this.estimateDuration(problemText)
-      });
-    }
-    if (brief.solutions.length > 0) {
-      const solutionText = this.formatForStyle(`The solution: ${brief.solutions.join(". ")}`, style);
-      segments.push({
-        sceneId: "solutions",
-        text: solutionText,
-        estimatedDurationSeconds: this.estimateDuration(solutionText)
-      });
-    }
-    if (brief.metrics && brief.metrics.length > 0) {
-      const metricsText = this.formatForStyle(`The results: ${brief.metrics.join(". ")}`, style);
-      segments.push({
-        sceneId: "metrics",
-        text: metricsText,
-        estimatedDurationSeconds: this.estimateDuration(metricsText)
-      });
-    }
-    if (brief.callToAction) {
-      const ctaText = this.formatForStyle(brief.callToAction, style);
-      segments.push({
-        sceneId: "cta",
-        text: ctaText,
-        estimatedDurationSeconds: this.estimateDuration(ctaText)
-      });
-    }
-    const fullText = segments.map((s) => s.text).join(" ");
-    const totalDuration = segments.reduce((sum, s) => sum + s.estimatedDurationSeconds, 0);
-    return {
-      fullText,
-      segments,
-      estimatedDurationSeconds: totalDuration,
-      style
-    };
-  }
-  async generateWithLlm(brief, style) {
-    const styleGuide = {
-      professional: "Use a clear, authoritative, professional tone. Be concise and direct.",
-      casual: "Use a friendly, conversational tone. Be approachable and relatable.",
-      technical: "Use precise technical language. Be detailed and accurate."
-    };
-    const styleKey = style ?? "professional";
-    const messages = [
-      {
-        role: "system",
-        content: [
-          {
-            type: "text",
-            text: `You are a video narration script writer.
-Write a narration script for a short video (30-60 seconds).
-${styleGuide[styleKey]}
-
-Return JSON with shape:
-{
-  "segments": [{ "sceneId": string, "text": string }],
-  "fullText": string
-}
-
-Scene IDs should be: "intro", "problems", "solutions", "metrics", "cta".
-Only include segments that are relevant to the brief content.`
-          }
-        ]
-      },
-      {
-        role: "user",
-        content: [{ type: "text", text: JSON.stringify(brief) }]
-      }
-    ];
-    if (!this.llm) {
-      return this.generateDeterministic(brief, style);
-    }
-    try {
-      const response = await this.llm.chat(messages, {
-        model: this.model,
-        temperature: this.temperature,
-        responseFormat: "json"
-      });
-      const text = response.message.content.find((p) => p.type === "text");
-      if (!text || text.type !== "text") {
-        return this.generateDeterministic(brief, style);
-      }
-      const parsed = JSON.parse(text.text);
-      const segments = parsed.segments.map((s) => ({
-        sceneId: s.sceneId,
-        text: s.text,
-        estimatedDurationSeconds: this.estimateDuration(s.text)
-      }));
-      return {
-        fullText: parsed.fullText,
-        segments,
-        estimatedDurationSeconds: segments.reduce((sum, s) => sum + s.estimatedDurationSeconds, 0),
-        style
-      };
-    } catch {
-      return this.generateDeterministic(brief, style);
-    }
-  }
-  formatForStyle(text, _style) {
-    return text;
-  }
-  estimateDuration(text) {
-    const wordCount = text.split(/\s+/).length;
-    return Math.ceil(wordCount / 150 * 60);
-  }
-}
-
 // src/generators/video-generator.ts
 import { VIDEO_FORMATS as VIDEO_FORMATS2 } from "@contractspec/lib.contracts-integrations/integrations/providers/video";
 class VideoGenerator {
   scenePlanner;
-  scriptGenerator;
   voice;
-  defaultVoiceId;
+  transcriber;
+  image;
   fps;
   constructor(options) {
     this.fps = options?.fps ?? DEFAULT_FPS;
     this.voice = options?.voice;
-    this.defaultVoiceId = options?.defaultVoiceId;
+    this.transcriber = options?.transcriber;
+    this.image = options?.image;
     this.scenePlanner = new ScenePlanner({
       llm: options?.llm,
       model: options?.model,
       temperature: options?.temperature,
-      fps: this.fps
-    });
-    this.scriptGenerator = new ScriptGenerator({
-      llm: options?.llm,
-      model: options?.model,
-      temperature: options?.temperature
+      fps: this.fps,
+      locale: options?.locale
     });
   }
   async generate(brief) {
     const scenePlan = await this.scenePlanner.plan(brief);
-    let narrationAudio;
-    if (brief.narration?.enabled && this.voice) {
-      const script = await this.scriptGenerator.generate(brief.content, brief.narration);
-      const voiceId = brief.narration.voiceId ?? this.defaultVoiceId;
-      if (voiceId && script.fullText) {
-        try {
-          const result = await this.voice.synthesize({
-            text: script.fullText,
-            voiceId,
-            format: "mp3"
-          });
-          narrationAudio = {
-            data: result.audio,
-            format: "mp3",
-            durationSeconds: result.durationSeconds ?? script.estimatedDurationSeconds,
-            volume: 1
-          };
-        } catch {}
-      }
-    }
-    const format = brief.format ?? VIDEO_FORMATS2.landscape;
     const scenes = scenePlan.scenes.map((planned, i) => ({
       id: `scene-${i}`,
       compositionId: planned.compositionId,
@@ -1471,6 +1814,70 @@ class VideoGenerator {
       durationInFrames: planned.durationInFrames,
       narrationText: planned.narrationText
     }));
+    let ttsProject;
+    let narrationAudio;
+    if (brief.narration?.enabled && this.voice) {
+      try {
+        ttsProject = await this.voice.synthesizeForVideo({
+          content: brief.content,
+          scenePlan: {
+            scenes: scenes.map((s) => ({
+              id: s.id,
+              compositionId: s.compositionId,
+              durationInFrames: s.durationInFrames,
+              narrationText: s.narrationText
+            })),
+            estimatedDurationSeconds: scenePlan.estimatedDurationSeconds
+          },
+          voice: { voiceId: brief.narration.voiceId ?? "" },
+          pacing: { strategy: "scene-matched" },
+          fps: this.fps
+        });
+        if (ttsProject.timingMap) {
+          for (const seg of ttsProject.timingMap.segments) {
+            const scene = scenes.find((s) => s.id === seg.sceneId);
+            if (scene) {
+              scene.durationInFrames = seg.recommendedSceneDurationInFrames;
+            }
+          }
+        }
+        if (ttsProject.assembledAudio) {
+          narrationAudio = {
+            data: ttsProject.assembledAudio.data,
+            format: ttsProject.assembledAudio.format === "wav" ? "wav" : "mp3",
+            durationSeconds: (ttsProject.assembledAudio.durationMs ?? 0) / 1000,
+            volume: 1
+          };
+        }
+      } catch {}
+    }
+    let subtitles;
+    if (this.transcriber && ttsProject?.assembledAudio) {
+      try {
+        const transcription = await this.transcriber.transcribe({
+          audio: ttsProject.assembledAudio,
+          subtitleFormat: "vtt"
+        });
+        subtitles = transcription.subtitles;
+      } catch {}
+    }
+    let thumbnail;
+    if (this.image) {
+      try {
+        const thumbProject = await this.image.generate({
+          content: brief.content,
+          purpose: "video-thumbnail",
+          format: "png",
+          style: "photorealistic"
+        });
+        const imageUrl = thumbProject.results?.images[0]?.url;
+        thumbnail = {
+          prompt: thumbProject.prompt.text,
+          ...imageUrl ? { imageUrl } : {}
+        };
+      } catch {}
+    }
+    const format = brief.format ?? VIDEO_FORMATS2.landscape;
     const totalDurationInFrames = scenes.reduce((sum, s) => sum + s.durationInFrames, 0);
     const project = {
       id: generateProjectId(),
@@ -1478,7 +1885,10 @@ class VideoGenerator {
       totalDurationInFrames,
       fps: this.fps,
       format,
-      audio: narrationAudio ? { narration: narrationAudio } : undefined
+      audio: narrationAudio ? { narration: narrationAudio } : undefined,
+      subtitles,
+      voiceTimingMap: ttsProject?.timingMap,
+      thumbnail
     };
     return project;
   }
@@ -1538,7 +1948,6 @@ export {
   TerminalDemo,
   Terminal,
   SocialClip,
-  ScriptGenerator,
   SceneTransitionWrapper,
   ScenePlanner,
   ProgressBar,