@contractspec/lib.video-gen 1.42.0

package/dist/renderers/config.d.ts

@@ -0,0 +1,28 @@
+import type { RenderConfig, VideoCodec, VideoOutputFormat } from '@contractspec/lib.contracts-integrations/integrations/providers/video';
+/** Default render configuration for local rendering. */
+export declare const defaultRenderConfig: Required<Pick<RenderConfig, 'codec' | 'outputFormat' | 'crf' | 'pixelFormat'>>;
+/** Codec-to-output-format mapping. */
+export declare const codecFormatMap: Record<VideoCodec, VideoOutputFormat>;
+/** Quality presets. */
+export declare const qualityPresets: {
+    /** Fastest render, lower quality (previews) */
+    readonly draft: {
+        readonly crf: 28;
+        readonly concurrency: 1;
+    };
+    /** Balanced quality/speed */
+    readonly standard: {
+        readonly crf: 18;
+        readonly concurrency: undefined;
+    };
+    /** Highest quality (final output) */
+    readonly high: {
+        readonly crf: 12;
+        readonly concurrency: undefined;
+    };
+};
+export type QualityPreset = keyof typeof qualityPresets;
+/**
+ * Merge user config with defaults.
+ */
+export declare function resolveRenderConfig(userConfig: RenderConfig, preset?: QualityPreset): RenderConfig;

package/dist/renderers/config.js

@@ -0,0 +1,35 @@
+// @bun
+var __require = import.meta.require;
+
+// src/renderers/config.ts
+var defaultRenderConfig = {
+  codec: "h264",
+  outputFormat: "mp4",
+  crf: 18,
+  pixelFormat: "yuv420p"
+};
+var codecFormatMap = {
+  h264: "mp4",
+  h265: "mp4",
+  vp8: "webm",
+  vp9: "webm"
+};
+var qualityPresets = {
+  draft: { crf: 28, concurrency: 1 },
+  standard: { crf: 18, concurrency: undefined },
+  high: { crf: 12, concurrency: undefined }
+};
+function resolveRenderConfig(userConfig, preset) {
+  const presetValues = preset ? qualityPresets[preset] : {};
+  return {
+    ...defaultRenderConfig,
+    ...presetValues,
+    ...userConfig
+  };
+}
+export {
+  resolveRenderConfig,
+  qualityPresets,
+  defaultRenderConfig,
+  codecFormatMap
+};

package/dist/renderers/index.d.ts

@@ -0,0 +1,3 @@
+export { LocalRenderer } from './local';
+export { resolveRenderConfig, defaultRenderConfig, qualityPresets, codecFormatMap, } from './config';
+export type { QualityPreset } from './config';

package/dist/renderers/index.js

@@ -0,0 +1,155 @@
+// @bun
+var __require = import.meta.require;
+
+// src/design/layouts.ts
+import { VIDEO_FORMATS } from "@contractspec/lib.contracts-integrations/integrations/providers/video";
+var DEFAULT_FPS = 30;
+var videoSafeZone = {
+  horizontal: 120,
+  vertical: 80,
+  contentWidth: 1680,
+  contentHeight: 920
+};
+function scaleSafeZone(format) {
+  const scaleX = format.width / 1920;
+  const scaleY = format.height / 1080;
+  return {
+    horizontal: Math.round(videoSafeZone.horizontal * scaleX),
+    vertical: Math.round(videoSafeZone.vertical * scaleY),
+    contentWidth: Math.round(videoSafeZone.contentWidth * scaleX),
+    contentHeight: Math.round(videoSafeZone.contentHeight * scaleY)
+  };
+}
+var videoPositions = {
+  center: { x: 960, y: 540 },
+  topLeft: { x: 120, y: 80 },
+  topRight: { x: 1800, y: 80 },
+  bottomLeft: { x: 120, y: 1000 },
+  bottomRight: { x: 1800, y: 1000 },
+  bottomCenter: { x: 960, y: 960 }
+};
+function getAllFormatVariants() {
+  return [
+    VIDEO_FORMATS.landscape,
+    VIDEO_FORMATS.square,
+    VIDEO_FORMATS.portrait
+  ];
+}
+
+// src/renderers/config.ts
+var defaultRenderConfig = {
+  codec: "h264",
+  outputFormat: "mp4",
+  crf: 18,
+  pixelFormat: "yuv420p"
+};
+var codecFormatMap = {
+  h264: "mp4",
+  h265: "mp4",
+  vp8: "webm",
+  vp9: "webm"
+};
+var qualityPresets = {
+  draft: { crf: 28, concurrency: 1 },
+  standard: { crf: 18, concurrency: undefined },
+  high: { crf: 12, concurrency: undefined }
+};
+function resolveRenderConfig(userConfig, preset) {
+  const presetValues = preset ? qualityPresets[preset] : {};
+  return {
+    ...defaultRenderConfig,
+    ...presetValues,
+    ...userConfig
+  };
+}
+
+// src/renderers/local.ts
+class LocalRenderer {
+  entryPoint;
+  constructor(options) {
+    this.entryPoint = options.entryPoint;
+  }
+  async render(project, config) {
+    const resolved = resolveRenderConfig(config);
+    const { bundle } = await import("@remotion/bundler");
+    const { renderMedia, selectComposition } = await import("@remotion/renderer");
+    const bundleLocation = await bundle({
+      entryPoint: this.entryPoint
+    });
+    const firstScene = project.scenes[0];
+    const mainCompositionId = project.scenes.length === 1 && firstScene ? firstScene.compositionId : "Master";
+    const composition = await selectComposition({
+      serveUrl: bundleLocation,
+      id: mainCompositionId,
+      inputProps: {
+        project
+      }
+    });
+    await renderMedia({
+      composition,
+      serveUrl: bundleLocation,
+      codec: resolved.codec,
+      outputLocation: resolved.outputPath,
+      inputProps: { project },
+      ...resolved.crf && { crf: resolved.crf },
+      ...resolved.concurrency && {
+        concurrency: resolved.concurrency
+      }
+    });
+    const result = {
+      outputPath: resolved.outputPath,
+      format: resolved.outputFormat ?? defaultRenderConfig.outputFormat,
+      codec: resolved.codec ?? defaultRenderConfig.codec,
+      durationSeconds: project.totalDurationInFrames / project.fps,
+      fileSizeBytes: 0,
+      dimensions: {
+        width: project.format.width,
+        height: project.format.height
+      }
+    };
+    if (config.autoVariants) {
+      const variants = getAllFormatVariants().filter((f) => f.type !== project.format.type);
+      const variantResults = [];
+      for (const variantFormat of variants) {
+        const variantPath = resolved.outputPath.replace(/(\.[^.]+)$/, `-${variantFormat.type}$1`);
+        const variantProject = {
+          ...project,
+          format: variantFormat
+        };
+        const variantComposition = await selectComposition({
+          serveUrl: bundleLocation,
+          id: mainCompositionId,
+          inputProps: { project: variantProject }
+        });
+        await renderMedia({
+          composition: variantComposition,
+          serveUrl: bundleLocation,
+          codec: resolved.codec,
+          outputLocation: variantPath,
+          inputProps: { project: variantProject },
+          ...resolved.crf && { crf: resolved.crf }
+        });
+        variantResults.push({
+          outputPath: variantPath,
+          format: resolved.outputFormat ?? defaultRenderConfig.outputFormat,
+          codec: resolved.codec ?? defaultRenderConfig.codec,
+          durationSeconds: project.totalDurationInFrames / project.fps,
+          fileSizeBytes: 0,
+          dimensions: {
+            width: variantFormat.width,
+            height: variantFormat.height
+          }
+        });
+      }
+      result.variants = variantResults;
+    }
+    return result;
+  }
+}
+export {
+  resolveRenderConfig,
+  qualityPresets,
+  defaultRenderConfig,
+  codecFormatMap,
+  LocalRenderer
+};

package/dist/renderers/local.d.ts

@@ -0,0 +1,17 @@
+import type { RenderConfig, RenderResult, VideoProject, VideoProvider } from '@contractspec/lib.contracts-integrations/integrations/providers/video';
+/**
+ * Local video renderer using @remotion/renderer.
+ *
+ * Usage:
+ * ```ts
+ * const renderer = new LocalRenderer({ entryPoint: './src/remotion/index.ts' });
+ * const result = await renderer.render(project, { outputPath: 'out/video.mp4' });
+ * ```
+ */
+export declare class LocalRenderer implements VideoProvider {
+    private readonly entryPoint;
+    constructor(options: {
+        entryPoint: string;
+    });
+    render(project: VideoProject, config: RenderConfig): Promise<RenderResult>;
+}

package/dist/renderers/local.js

@@ -0,0 +1,151 @@
+// @bun
+var __require = import.meta.require;
+
+// src/design/layouts.ts
+import { VIDEO_FORMATS } from "@contractspec/lib.contracts-integrations/integrations/providers/video";
+var DEFAULT_FPS = 30;
+var videoSafeZone = {
+  horizontal: 120,
+  vertical: 80,
+  contentWidth: 1680,
+  contentHeight: 920
+};
+function scaleSafeZone(format) {
+  const scaleX = format.width / 1920;
+  const scaleY = format.height / 1080;
+  return {
+    horizontal: Math.round(videoSafeZone.horizontal * scaleX),
+    vertical: Math.round(videoSafeZone.vertical * scaleY),
+    contentWidth: Math.round(videoSafeZone.contentWidth * scaleX),
+    contentHeight: Math.round(videoSafeZone.contentHeight * scaleY)
+  };
+}
+var videoPositions = {
+  center: { x: 960, y: 540 },
+  topLeft: { x: 120, y: 80 },
+  topRight: { x: 1800, y: 80 },
+  bottomLeft: { x: 120, y: 1000 },
+  bottomRight: { x: 1800, y: 1000 },
+  bottomCenter: { x: 960, y: 960 }
+};
+function getAllFormatVariants() {
+  return [
+    VIDEO_FORMATS.landscape,
+    VIDEO_FORMATS.square,
+    VIDEO_FORMATS.portrait
+  ];
+}
+
+// src/renderers/config.ts
+var defaultRenderConfig = {
+  codec: "h264",
+  outputFormat: "mp4",
+  crf: 18,
+  pixelFormat: "yuv420p"
+};
+var codecFormatMap = {
+  h264: "mp4",
+  h265: "mp4",
+  vp8: "webm",
+  vp9: "webm"
+};
+var qualityPresets = {
+  draft: { crf: 28, concurrency: 1 },
+  standard: { crf: 18, concurrency: undefined },
+  high: { crf: 12, concurrency: undefined }
+};
+function resolveRenderConfig(userConfig, preset) {
+  const presetValues = preset ? qualityPresets[preset] : {};
+  return {
+    ...defaultRenderConfig,
+    ...presetValues,
+    ...userConfig
+  };
+}
+
+// src/renderers/local.ts
+class LocalRenderer {
+  entryPoint;
+  constructor(options) {
+    this.entryPoint = options.entryPoint;
+  }
+  async render(project, config) {
+    const resolved = resolveRenderConfig(config);
+    const { bundle } = await import("@remotion/bundler");
+    const { renderMedia, selectComposition } = await import("@remotion/renderer");
+    const bundleLocation = await bundle({
+      entryPoint: this.entryPoint
+    });
+    const firstScene = project.scenes[0];
+    const mainCompositionId = project.scenes.length === 1 && firstScene ? firstScene.compositionId : "Master";
+    const composition = await selectComposition({
+      serveUrl: bundleLocation,
+      id: mainCompositionId,
+      inputProps: {
+        project
+      }
+    });
+    await renderMedia({
+      composition,
+      serveUrl: bundleLocation,
+      codec: resolved.codec,
+      outputLocation: resolved.outputPath,
+      inputProps: { project },
+      ...resolved.crf && { crf: resolved.crf },
+      ...resolved.concurrency && {
+        concurrency: resolved.concurrency
+      }
+    });
+    const result = {
+      outputPath: resolved.outputPath,
+      format: resolved.outputFormat ?? defaultRenderConfig.outputFormat,
+      codec: resolved.codec ?? defaultRenderConfig.codec,
+      durationSeconds: project.totalDurationInFrames / project.fps,
+      fileSizeBytes: 0,
+      dimensions: {
+        width: project.format.width,
+        height: project.format.height
+      }
+    };
+    if (config.autoVariants) {
+      const variants = getAllFormatVariants().filter((f) => f.type !== project.format.type);
+      const variantResults = [];
+      for (const variantFormat of variants) {
+        const variantPath = resolved.outputPath.replace(/(\.[^.]+)$/, `-${variantFormat.type}$1`);
+        const variantProject = {
+          ...project,
+          format: variantFormat
+        };
+        const variantComposition = await selectComposition({
+          serveUrl: bundleLocation,
+          id: mainCompositionId,
+          inputProps: { project: variantProject }
+        });
+        await renderMedia({
+          composition: variantComposition,
+          serveUrl: bundleLocation,
+          codec: resolved.codec,
+          outputLocation: variantPath,
+          inputProps: { project: variantProject },
+          ...resolved.crf && { crf: resolved.crf }
+        });
+        variantResults.push({
+          outputPath: variantPath,
+          format: resolved.outputFormat ?? defaultRenderConfig.outputFormat,
+          codec: resolved.codec ?? defaultRenderConfig.codec,
+          durationSeconds: project.totalDurationInFrames / project.fps,
+          fileSizeBytes: 0,
+          dimensions: {
+            width: variantFormat.width,
+            height: variantFormat.height
+          }
+        });
+      }
+      result.variants = variantResults;
+    }
+    return result;
+  }
+}
+export {
+  LocalRenderer
+};

package/dist/types.d.ts

@@ -0,0 +1,63 @@
+import type { LLMProvider } from '@contractspec/lib.contracts-integrations/integrations/providers/llm';
+import type { VoiceProvider } from '@contractspec/lib.contracts-integrations/integrations/providers/voice';
+import type { ContentBrief } from '@contractspec/lib.content-gen/types';
+import type { NarrationConfig, VideoFormat, VideoProject, VideoStyleOverrides } from '@contractspec/lib.contracts-integrations/integrations/providers/video';
+export type { AudioTrack, CompositionMeta, CompositionRegistry, NarrationConfig, RenderConfig, RenderResult, SceneTransition, SceneTransitionType, VideoCodec, VideoFormat, VideoFormatCustom, VideoFormatLandscape, VideoFormatPortrait, VideoFormatSquare, VideoOutputFormat, VideoProject, VideoProjectMetadata, VideoProvider, VideoScene, VideoStyleOverrides, } from '@contractspec/lib.contracts-integrations/integrations/providers/video';
+export { VIDEO_FORMATS } from '@contractspec/lib.contracts-integrations/integrations/providers/video';
+/**
+ * Input for the video generation pipeline.
+ * Builds on top of ContentBrief to keep a unified content pipeline.
+ */
+export interface VideoBrief {
+    /** The content brief driving the video narrative */
+    content: ContentBrief;
+    /** Target video format / dimensions */
+    format: VideoFormat;
+    /** Target duration in seconds. Auto-calculated from scenes if omitted. */
+    targetDurationSeconds?: number;
+    /** Narration configuration */
+    narration?: NarrationConfig;
+    /** Visual style overrides */
+    style?: VideoStyleOverrides;
+    /** Composition template to use (if known). Otherwise scene planner picks. */
+    compositionId?: string;
+}
+export interface VideoGeneratorOptions {
+    /** Optional LLM for enhanced scene planning & script generation */
+    llm?: LLMProvider;
+    /** Optional voice provider for narration synthesis */
+    voice?: VoiceProvider;
+    /** LLM model override */
+    model?: string;
+    /** LLM temperature (0-1). Default 0.4 for determinism. */
+    temperature?: number;
+    /** Default voice ID for narration */
+    defaultVoiceId?: string;
+    /** Default FPS. Default 30. */
+    fps?: number;
+}
+export interface GeneratedVideo {
+    project: VideoProject;
+    /** Set after rendering */
+    outputPath?: string;
+    format: 'mp4' | 'webm' | 'gif';
+    /** Auto-generated social format variants */
+    variants?: GeneratedVideoVariant[];
+}
+export interface GeneratedVideoVariant {
+    format: VideoFormat;
+    outputPath: string;
+    durationSeconds: number;
+}
+export interface ScenePlan {
+    scenes: PlannedScene[];
+    estimatedDurationSeconds: number;
+    narrationScript?: string;
+}
+export interface PlannedScene {
+    compositionId: string;
+    props: Record<string, unknown>;
+    durationInFrames: number;
+    narrationText?: string;
+    notes?: string;
+}

package/dist/types.js

@@ -0,0 +1,8 @@
+// @bun
+var __require = import.meta.require;
+
+// src/types.ts
+import { VIDEO_FORMATS } from "@contractspec/lib.contracts-integrations/integrations/providers/video";
+export {
+  VIDEO_FORMATS
+};