@lssm-tech/lib.video-gen 3.0.10 → 5.0.2

package/dist/docs/compositions.docblock.js

@@ -1,2 +0,0 @@
-// @bun
-import{registerDocBlocks as f}from"@contractspec/lib.contracts-spec/docs";var h=[{id:"docs.video-gen.compositions",title:"Video Compositions & Primitives",summary:"Remotion composition components and reusable primitives for building programmatic videos.",kind:"reference",visibility:"public",route:"/docs/video-gen/compositions",tags:["video","remotion","compositions","primitives","react"],owners:["@contractspec/lib.video-gen"],body:'# Video Compositions & Primitives\n\nCompositions are React components rendered by Remotion. They use `useCurrentFrame()`, `useVideoConfig()`, and `interpolate()` to produce frame-accurate animations. All compositions must be **deterministic**: same props = same visual output.\n\n## Primitive Components\n\nPrimitives are reusable building blocks for constructing full compositions.\n\n```ts\nimport {\n  AnimatedText,\n  CodeBlock,\n  Terminal,\n  BrandFrame,\n  ProgressBar,\n  SceneTransitionWrapper,\n} from "@contractspec/lib.video-gen/compositions/primitives";\n```\n\n### AnimatedText\n\nText with entrance/exit slide + fade animations.\n\n| Prop | Type | Default | Description |\n|------|------|---------|-------------|\n| `text` | `string` | -- | Text content |\n| `variant` | `keyof videoTypography` | `"body"` | Typography preset (title, heading, subheading, body, code, caption, label) |\n| `enterAt` | `number` | `0` | Frame at which text enters |\n| `exitAt` | `number` | -- | Frame at which text exits (omit to keep visible) |\n| `color` | `string` | `"#ffffff"` | Text color |\n| `align` | `"left" \\| "center" \\| "right"` | `"left"` | Text alignment |\n\n### CodeBlock\n\nSyntax-aware code display with typing animation and macOS-style title bar.\n\n| Prop | Type | Default | Description |\n|------|------|---------|-------------|\n| `code` | `string` | -- | Code string to display |\n| `language` | `string` | `"typescript"` | Language label in the title bar |\n| `startAt` | `number` | `0` | Frame at which typing starts |\n| `typeAnimation` | `boolean` | `true` | Animate character-by-character typing |\n| `filename` | `string` | -- | Filename in the title bar (overrides language) |\n\n### Terminal\n\nCLI simulator with command typing, output lines, and cursor animation.\n\n| Prop | Type | Default | Description |\n|------|------|---------|-------------|\n| `lines` | `TerminalLine[]` | -- | Lines to display in sequence |\n| `startAt` | `number` | `0` | Frame at which terminal appears |\n| `prompt` | `string` | `"$ "` | Prompt string before commands |\n| `title` | `string` | `"Terminal"` | Title bar text |\n| `typingSpeed` | `number` | `2` | Frames per character for commands |\n\n`TerminalLine` types: `command` (typed), `output` (faded in), `error` (red), `success` (green), `comment` (dimmed with `#` prefix).\n\n### BrandFrame\n\nBranded container with safe-zone padding, gradient/solid/dark backgrounds, and optional watermark.\n\n| Prop | Type | Default | Description |\n|------|------|---------|-------------|\n| `variant` | `"solid" \\| "gradient" \\| "dark"` | `"gradient"` | Background style |\n| `showBranding` | `boolean` | `true` | Show "ContractSpec" watermark |\n| `animateEntrance` | `boolean` | `true` | Fade-in on first frames |\n| `styleOverrides` | `VideoStyleOverrides` | -- | Override colors, fonts, dark mode |\n\n### ProgressBar\n\nThin progress indicator at the top or bottom of the frame.\n\n| Prop | Type | Default | Description |\n|------|------|---------|-------------|\n| `height` | `number` | `4` | Bar height in pixels |\n| `color` | `string` | primary color | Bar fill color |\n| `position` | `"top" \\| "bottom"` | `"bottom"` | Placement |\n\n### SceneTransitionWrapper\n\nWraps children with entrance/exit transitions (fade, slide-left, slide-right, wipe).\n\n| Prop | Type | Default | Description |\n|------|------|---------|-------------|\n| `type` | `SceneTransitionType` | -- | Transition type |\n| `durationInFrames` | `number` | -- | Transition duration |\n| `direction` | `"in" \\| "out"` | -- | Entering or exiting |\n\n## Full Compositions\n\nFull compositions combine primitives into complete video templates. They are registered in Remotion Studio via `RemotionRoot`.\n\n### ApiOverview\n\nVisualizes a ContractSpec definition generating a full API surface. Used for homepage demos and documentation.\n\n```tsx\nimport { ApiOverview } from "@contractspec/lib.video-gen/compositions/api-overview";\n\n<ApiOverview\n  specName="CreateUser"\n  method="POST"\n  endpoint="/api/users"\n  specCode={`export const createUser = defineCommand({...})`}\n  generatedOutputs={["REST Endpoint", "GraphQL Mutation", "Prisma Model"]}\n  tagline="One spec. Every surface."\n/>\n```\n\n**Scenes**: Title + method badge -> Code typing animation -> Generated outputs fan-out -> Tagline.\n\n### SocialClip\n\nShort-form marketing content for LinkedIn, X, YouTube Shorts. Adapts layout for landscape (16:9), square (1:1), and portrait (9:16).\n\n```tsx\nimport { SocialClip } from "@contractspec/lib.video-gen/compositions/social-clip";\n\n<SocialClip\n  hook="Stop rewriting the same API logic."\n  message="Generate REST, GraphQL, DB, SDK from a single spec."\n  points={["Deterministic output", "Fully ejectable", "No lock-in"]}\n  cta="Try ContractSpec"\n  ctaUrl="contractspec.dev"\n/>\n```\n\n**Scenes**: Hook (attention grabber) -> Main message -> Supporting points -> CTA button.\n\n### TerminalDemo\n\nCLI command walkthrough with animated terminal. Used in documentation and tutorial videos.\n\n```tsx\nimport { TerminalDemo } from "@contractspec/lib.video-gen/compositions/terminal-demo";\n\n<TerminalDemo\n  title="Getting Started with ContractSpec"\n  subtitle="Define once, generate everything."\n  lines={[\n    { type: "command", text: "npx contractspec init my-api" },\n    { type: "output", text: "Created my-api/ with 3 sample contracts" },\n    { type: "command", text: "npx contractspec build" },\n    { type: "success", text: "Built 3 contracts -> 18 generated files" },\n  ]}\n  summary="Ship faster. Stay coherent."\n/>\n```\n\n**Scenes**: Title + subtitle -> Terminal typing animation -> Summary.\n\n## Creating New Compositions\n\n1. Create a new `.tsx` file in `src/compositions/`.\n2. Use primitives from `./primitives/` and design tokens from `../design/`.\n3. Use `useCurrentFrame()` and `interpolate()` for frame-based animations.\n4. Register in `src/remotion/Root.tsx` with a `<Composition>` entry.\n5. Export from `src/compositions/index.ts`.\n6. Add the export path to `package.json` (both workspace and publishConfig).\n\n### Guardrails\n\n- Keep compositions **pure**: no side effects, no network calls, no randomness.\n- Use `scaleSafeZone()` and `scaleTypography()` to support multiple formats.\n- All timing should be frame-based (not time-based) for deterministic output.\n'}];f(h);

package/dist/docs/design.docblock.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/docs/design.docblock.js

@@ -1,173 +0,0 @@
-// @bun
-import{registerDocBlocks as f}from"@contractspec/lib.contracts-spec/docs";var h=[{id:"docs.video-gen.design",title:"Video Design System",summary:"Design tokens, motion primitives, typography scale, and layout system optimized for programmatic video.",kind:"reference",visibility:"public",route:"/docs/video-gen/design",tags:["video","design-tokens","motion","typography","layout"],owners:["@contractspec/lib.video-gen"],body:`# Video Design System
-
-The design layer bridges \`@contractspec/lib.design-system\` brand tokens with video-specific extensions for motion, typography, and spatial layout. All values are optimized for 1920x1080 (landscape) and scale proportionally for other formats.
-
-\`\`\`ts
-import {
-  defaultVideoTheme,
-  videoEasing,
-  videoDurations,
-  videoTypography,
-  videoSafeZone,
-  scaleSafeZone,
-} from "@contractspec/lib.video-gen/design";
-\`\`\`
-
-## Tokens
-
-### Brand Bridge
-
-\`VideoThemeTokens\` extends the design-system \`ThemeTokens\` with a \`video\` namespace for video-specific colors:
-
-\`\`\`ts
-import { defaultVideoTheme } from "@contractspec/lib.video-gen/design/tokens";
-
-// Brand tokens (from @contractspec/lib.design-system)
-defaultVideoTheme.colors.primary;    // brand primary
-defaultVideoTheme.colors.accent;     // brand accent
-
-// Video-specific extensions
-defaultVideoTheme.video.canvasBackground;    // frame background
-defaultVideoTheme.video.codeBackground;      // "#1e1e2e"
-defaultVideoTheme.video.terminalBackground;  // "#0d1117"
-defaultVideoTheme.video.terminalForeground;  // "#c9d1d9"
-defaultVideoTheme.video.highlight;           // accent color
-defaultVideoTheme.video.gradientStart;       // primary
-defaultVideoTheme.video.gradientEnd;         // accent
-\`\`\`
-
-> Do not duplicate brand color values. Import and extend from \`@contractspec/lib.design-system\`.
-
-## Motion
-
-### Easing Functions
-
-Pre-configured easing curves for use with Remotion's \`interpolate()\`:
-
-| Key | Easing | Use Case |
-|-----|--------|----------|
-| \`entrance\` | \`Easing.out(Easing.exp)\` | Objects appearing |
-| \`exit\` | \`Easing.in(Easing.exp)\` | Objects disappearing |
-| \`emphasis\` | \`Easing.out(Easing.back(1.4))\` | Drawing attention, bounce |
-| \`linear\` | \`Easing.linear\` | Progress bars, typing |
-| \`gentle\` | \`Easing.bezier(0.25, 0.1, 0.25, 1)\` | Subtle movements |
-| \`spring\` | \`Easing.out(Easing.back(1.7))\` | Playful movements |
-
-\`\`\`ts
-import { interpolate } from "remotion";
-import { videoEasing } from "@contractspec/lib.video-gen/design/motion";
-
-const opacity = interpolate(frame, [0, 15], [0, 1], {
-  easing: videoEasing.entrance,
-  extrapolateLeft: "clamp",
-  extrapolateRight: "clamp",
-});
-\`\`\`
-
-### Durations (frames at 30fps)
-
-| Key | Frames | Seconds | Use Case |
-|-----|--------|---------|----------|
-| \`sceneTransition\` | 20 | 0.67s | Between scenes |
-| \`textEntrance\` | 15 | 0.5s | Text slide-in |
-| \`textExit\` | 12 | 0.4s | Text slide-out |
-| \`codeTypingPerChar\` | 2 | 0.07s | Code typing speed |
-| \`sectionPause\` | 30 | 1.0s | Pause after concept |
-| \`emphasisPause\` | 15 | 0.5s | Brief emphasis |
-| \`brandReveal\` | 25 | 0.83s | Logo/watermark |
-| \`minScene\` | 60 | 2.0s | Minimum scene length |
-| \`shortScene\` | 60 | 2.0s | Short scene |
-| \`mediumScene\` | 120 | 4.0s | Medium scene |
-| \`longScene\` | 240 | 8.0s | Long scene |
-
-### Transition Presets
-
-\`\`\`ts
-import { videoTransitions } from "@contractspec/lib.video-gen/design/motion";
-
-// { type: "fade", durationInFrames: 20 }
-videoTransitions.fade;
-
-// { type: "slide-left", durationInFrames: 20 }
-videoTransitions.slideLeft;
-\`\`\`
-
-## Typography
-
-### Type Scale (1920x1080 baseline)
-
-| Key | Size | Weight | Use Case |
-|-----|------|--------|----------|
-| \`title\` | 72px | 700 | Main title |
-| \`heading\` | 56px | 600 | Section heading |
-| \`subheading\` | 40px | 500 | Subheading |
-| \`body\` | 32px | 400 | Body text |
-| \`code\` | 28px | 400 | Monospace code |
-| \`caption\` | 24px | 400 | Small caption |
-| \`label\` | 20px | 600 | Badge / label |
-
-### Scaling for Other Formats
-
-Use \`scaleTypography()\` to proportionally scale for non-landscape formats:
-
-\`\`\`ts
-import {
-  videoTypography,
-  scaleTypography,
-} from "@contractspec/lib.video-gen/design/typography";
-
-// Scale heading for 1080x1080 (square)
-const squareHeading = scaleTypography(videoTypography.heading, 1080);
-// -> fontSize: 32, lineHeight: 1.2, fontWeight: 600
-\`\`\`
-
-## Layouts
-
-### Safe Zones
-
-Content-safe padding for text within video frames (1920x1080 baseline):
-
-\`\`\`ts
-import {
-  videoSafeZone,
-  scaleSafeZone,
-} from "@contractspec/lib.video-gen/design/layouts";
-
-videoSafeZone.horizontal;   // 120px
-videoSafeZone.vertical;     // 80px
-videoSafeZone.contentWidth;  // 1680px
-videoSafeZone.contentHeight; // 920px
-
-// Scale for portrait (1080x1920)
-const portrait = scaleSafeZone({ type: "portrait", width: 1080, height: 1920 });
-\`\`\`
-
-### Standard Positions
-
-\`\`\`ts
-import { videoPositions } from "@contractspec/lib.video-gen/design/layouts";
-
-videoPositions.center;       // { x: 960, y: 540 }
-videoPositions.topLeft;      // { x: 120, y: 80 }
-videoPositions.bottomRight;  // { x: 1800, y: 1000 } -- logos, watermarks
-videoPositions.bottomCenter; // { x: 960, y: 960 } -- captions
-\`\`\`
-
-### Format Variants
-
-\`\`\`ts
-import {
-  VIDEO_FORMATS,
-  getAllFormatVariants,
-  DEFAULT_FPS,
-} from "@contractspec/lib.video-gen/design/layouts";
-
-VIDEO_FORMATS.landscape; // { type: "landscape", width: 1920, height: 1080 }
-VIDEO_FORMATS.portrait;  // { type: "portrait",  width: 1080, height: 1920 }
-VIDEO_FORMATS.square;    // { type: "square",    width: 1080, height: 1080 }
-
-getAllFormatVariants();   // [landscape, square, portrait]
-DEFAULT_FPS;             // 30
-\`\`\`
-`}];f(h);

package/dist/docs/generators.docblock.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/docs/generators.docblock.js

@@ -1,166 +0,0 @@
-// @bun
-import{registerDocBlocks as f}from"@contractspec/lib.contracts-spec/docs";var h=[{id:"docs.video-gen.generators",title:"Video Generation Pipeline",summary:"VideoGenerator, ScenePlanner, and ScriptGenerator -- from content brief to video project with optional LLM enhancement.",kind:"reference",visibility:"public",route:"/docs/video-gen/generators",tags:["video","generators","scene-planner","script-generator","llm","content-pipeline"],owners:["@contractspec/lib.video-gen"],body:`# Video Generation Pipeline
-
-The generators layer converts a \`VideoBrief\` (content brief + video config) into a fully specified \`VideoProject\` (scene graph ready for rendering). It follows the \`@contractspec/lib.content-gen\` pattern: optional LLM, deterministic fallback.
-
-\`\`\`
-VideoBrief
-    |
-    v
-ScenePlanner.plan(brief)       --> ScenePlan (scenes + durations)
-    |
-    v
-ScriptGenerator.generate(brief) --> NarrationScript (text + segments)
-    |
-    v
-VoiceProvider.synthesize(text)  --> AudioTrack (optional)
-    |
-    v
-VideoGenerator.generate(brief)  --> VideoProject (complete scene graph)
-\`\`\`
-
-## VideoGenerator
-
-The main orchestrator. Wires ScenePlanner, ScriptGenerator, and optional VoiceProvider into a single pipeline.
-
-\`\`\`ts
-import { VideoGenerator } from "@contractspec/lib.video-gen/generators";
-import type { VideoBrief } from "@contractspec/lib.video-gen/types";
-
-// Minimal (deterministic, no LLM, no voice)
-const generator = new VideoGenerator({ fps: 30 });
-
-// Full (with LLM for richer scenes + voice narration)
-const generator = new VideoGenerator({
-  llm: myLLMProvider,
-  voice: myVoiceProvider,
-  model: "gpt-4o",
-  temperature: 0.4,
-  defaultVoiceId: "rachel",
-  fps: 30,
-});
-
-const project = await generator.generate(brief);
-\`\`\`
-
-### Pipeline Steps
-
-1. **Scene planning** -- \`ScenePlanner.plan(brief)\` breaks the brief into concrete \`PlannedScene[]\` with composition IDs, props, and durations.
-2. **Script generation** -- If \`brief.narration.enabled\`, \`ScriptGenerator.generate()\` produces a \`NarrationScript\` with per-scene text segments.
-3. **Voice synthesis** -- If a \`VoiceProvider\` is configured and narration is enabled, synthesizes audio via \`voice.synthesize()\`.
-4. **Assembly** -- Combines scenes, audio, and metadata into a \`VideoProject\`.
-
-### Constructor Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| \`llm\` | \`LLMProvider\` | -- | Optional LLM for enhanced generation |
-| \`voice\` | \`VoiceProvider\` | -- | Optional voice synthesis provider |
-| \`model\` | \`string\` | -- | LLM model override |
-| \`temperature\` | \`number\` | \`0.4\` | LLM temperature (lower = more deterministic) |
-| \`defaultVoiceId\` | \`string\` | -- | Default voice for narration |
-| \`fps\` | \`number\` | \`30\` | Frames per second |
-
-## ScenePlanner
-
-Breaks a \`VideoBrief\` into concrete scenes mapped to registered compositions.
-
-\`\`\`ts
-import { ScenePlanner } from "@contractspec/lib.video-gen/generators";
-
-const planner = new ScenePlanner({ fps: 30 });
-const plan = await planner.plan(brief);
-
-plan.scenes;                    // PlannedScene[]
-plan.estimatedDurationSeconds;  // total estimated duration
-plan.narrationScript;           // combined narration text
-\`\`\`
-
-### Deterministic Path (no LLM)
-
-Maps brief sections to \`SocialClip\` compositions:
-
-| Brief Section | Scene | Duration |
-|---------------|-------|----------|
-| \`title\` + \`summary\` | Hook / title | 3s |
-| \`problems\` | Problem statement | 4s |
-| \`solutions\` | Solution showcase | 5s |
-| \`metrics\` | Proof / results | 3s |
-| \`callToAction\` | CTA | 2s |
-
-If \`brief.targetDurationSeconds\` is set, all scene durations are scaled proportionally.
-
-### LLM-Enhanced Path
-
-With an \`LLMProvider\`, the planner sends the brief to the LLM and requests a scene breakdown as JSON. The LLM can choose from \`ApiOverview\`, \`SocialClip\`, or \`TerminalDemo\` compositions. Falls back to deterministic on any failure.
-
-## ScriptGenerator
-
-Produces narration text from a \`ContentBrief\` with style control.
-
-\`\`\`ts
-import { ScriptGenerator } from "@contractspec/lib.video-gen/generators";
-
-const scriptGen = new ScriptGenerator({ temperature: 0.5 });
-const script = await scriptGen.generate(brief.content, brief.narration);
-
-script.fullText;                // complete narration
-script.segments;                // NarrationSegment[] (per-scene text)
-script.estimatedDurationSeconds; // at ~150 words/min
-script.style;                   // "professional" | "casual" | "technical"
-\`\`\`
-
-### Narration Styles
-
-| Style | Tone |
-|-------|------|
-| \`professional\` | Clear, authoritative, concise |
-| \`casual\` | Friendly, conversational, approachable |
-| \`technical\` | Precise, detailed, accurate |
-
-### NarrationSegment
-
-Each segment maps to a scene and provides timing estimates:
-
-\`\`\`ts
-interface NarrationSegment {
-  sceneId: string;                // "intro", "problems", "solutions", "metrics", "cta"
-  text: string;                   // narration text for this segment
-  estimatedDurationSeconds: number; // at ~150 words/min
-}
-\`\`\`
-
-## Input Types
-
-### VideoBrief
-
-\`\`\`ts
-interface VideoBrief {
-  content: ContentBrief;            // from @contractspec/lib.content-gen
-  format: VideoFormat;              // landscape, portrait, square, or custom
-  targetDurationSeconds?: number;   // auto-calculated if omitted
-  narration?: NarrationConfig;      // { enabled, voiceId, language, style }
-  style?: VideoStyleOverrides;      // colors, fonts, dark mode
-  compositionId?: string;           // force a specific composition
-}
-\`\`\`
-
-### PlannedScene
-
-\`\`\`ts
-interface PlannedScene {
-  compositionId: string;            // maps to a registered Remotion composition
-  props: Record<string, unknown>;   // input props for the composition
-  durationInFrames: number;         // scene duration
-  narrationText?: string;           // narrator text for this scene
-  notes?: string;                   // planning notes (LLM path only)
-}
-\`\`\`
-
-## Guardrails
-
-- Generators are **stateless** -- no side effects, no caching. Call \`generate()\` / \`plan()\` for each video.
-- LLM responses are parsed as JSON; any parse failure falls back to deterministic.
-- Temperature defaults are conservative (0.3-0.5) for reproducibility.
-- Duration estimates use 150 words/min speaking rate.
-`}];f(h);

package/dist/docs/rendering.docblock.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/docs/rendering.docblock.js

@@ -1,176 +0,0 @@
-// @bun
-import{registerDocBlocks as f}from"@contractspec/lib.contracts-spec/docs";var h=[{id:"docs.video-gen.rendering",title:"Video Rendering & Playback",summary:"LocalRenderer for MP4 output, render configuration, quality presets, DemoPlayer for web embedding, and Remotion Studio setup.",kind:"reference",visibility:"public",route:"/docs/video-gen/rendering",tags:["video","rendering","remotion","player","mp4","quality-presets"],owners:["@contractspec/lib.video-gen"],body:`# Video Rendering & Playback
-
-The rendering layer wraps \`@remotion/renderer\` for MP4/WebM output and \`@remotion/player\` for interactive web embedding. It implements the \`VideoProvider\` contract from \`@contractspec/lib.contracts-integrations\`.
-
-## LocalRenderer
-
-Renders a \`VideoProject\` to a video file using the local Remotion renderer. Works with **Node.js** and **Bun** (via \`remotionb\`). Bun caveat: SSR scripts may not auto-quit (see [Remotion Bun docs](https://www.remotion.dev/docs/bun)).
-
-\`\`\`ts
-import { LocalRenderer } from "@contractspec/lib.video-gen/renderers/local";
-
-const renderer = new LocalRenderer({
-  entryPoint: "./src/remotion/index.ts",
-});
-
-const result = await renderer.render(project, {
-  outputPath: "out/video.mp4",
-  codec: "h264",
-  crf: 18,
-});
-
-result.outputPath;      // "out/video.mp4"
-result.format;          // "mp4"
-result.durationSeconds; // total duration
-result.fileSizeBytes;   // file size
-result.dimensions;      // { width: 1920, height: 1080 }
-\`\`\`
-
-> **Important**: Import \`LocalRenderer\` from the \`/renderers/local\` subpath, not from the main entry. It dynamically imports \`@remotion/bundler\` and \`@remotion/renderer\` to avoid bundling them in browser builds.
-
-### Auto-Variants
-
-Set \`autoVariants: true\` to generate landscape + square + portrait versions:
-
-\`\`\`ts
-const result = await renderer.render(project, {
-  outputPath: "out/video.mp4",
-  autoVariants: true,
-});
-
-result.variants; // [
-//   { outputPath: "out/video-square.mp4", dimensions: { width: 1080, height: 1080 } },
-//   { outputPath: "out/video-portrait.mp4", dimensions: { width: 1080, height: 1920 } },
-// ]
-\`\`\`
-
-## Render Configuration
-
-### Defaults
-
-\`\`\`ts
-import {
-  defaultRenderConfig,
-  resolveRenderConfig,
-  qualityPresets,
-  codecFormatMap,
-} from "@contractspec/lib.video-gen/renderers/config";
-
-defaultRenderConfig.codec;       // "h264"
-defaultRenderConfig.outputFormat; // "mp4"
-defaultRenderConfig.crf;         // 18
-defaultRenderConfig.pixelFormat; // "yuv420p"
-\`\`\`
-
-### RenderConfig Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| \`outputPath\` | \`string\` | -- | **Required**. Output file path |
-| \`codec\` | \`"h264" \\| "h265" \\| "vp8" \\| "vp9"\` | \`"h264"\` | Video codec |
-| \`outputFormat\` | \`"mp4" \\| "webm" \\| "gif"\` | \`"mp4"\` | Container format |
-| \`crf\` | \`number\` | \`18\` | Constant Rate Factor (lower = better quality) |
-| \`pixelFormat\` | \`string\` | \`"yuv420p"\` | Pixel format |
-| \`concurrency\` | \`number\` | CPU count | Rendering threads |
-| \`autoVariants\` | \`boolean\` | \`false\` | Generate format variants |
-
-### Quality Presets
-
-\`\`\`ts
-import { resolveRenderConfig } from "@contractspec/lib.video-gen/renderers/config";
-
-// Draft (fastest, for previews)
-resolveRenderConfig({ outputPath: "out/preview.mp4" }, "draft");
-// -> crf: 28, concurrency: 1
-
-// Standard (balanced)
-resolveRenderConfig({ outputPath: "out/video.mp4" }, "standard");
-// -> crf: 18
-
-// High (best quality, for final output)
-resolveRenderConfig({ outputPath: "out/final.mp4" }, "high");
-// -> crf: 12
-\`\`\`
-
-### Codec-to-Format Mapping
-
-| Codec | Format |
-|-------|--------|
-| \`h264\` | \`mp4\` |
-| \`h265\` | \`mp4\` |
-| \`vp8\` | \`webm\` |
-| \`vp9\` | \`webm\` |
-
-## DemoPlayer (Web Embedding)
-
-Embeddable Remotion Player for interactive video demos in React apps. Wraps \`@remotion/player\` with ContractSpec compositions.
-
-\`\`\`tsx
-import { DemoPlayer } from "@contractspec/lib.video-gen/player";
-
-<DemoPlayer
-  compositionId="ApiOverview"
-  inputProps={{
-    specName: "CreateUser",
-    specCode: "export const createUser = defineCommand({...})",
-  }}
-  controls
-  autoPlay
-  loop
-  width="100%"
-  clickToPlay
-  doubleClickToFullscreen
-/>
-\`\`\`
-
-### DemoPlayer Props
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| \`compositionId\` | \`"ApiOverview" \\| "SocialClip" \\| "TerminalDemo"\` | -- | Composition to play |
-| \`inputProps\` | composition props type | -- | Props for the selected composition |
-| \`controls\` | \`boolean\` | \`true\` | Show playback controls |
-| \`autoPlay\` | \`boolean\` | \`false\` | Auto-play on mount |
-| \`loop\` | \`boolean\` | \`false\` | Loop playback |
-| \`width\` | \`string \\| number\` | \`"100%"\` | Player width |
-| \`height\` | \`string \\| number\` | \`"auto"\` | Player height |
-| \`clickToPlay\` | \`boolean\` | \`true\` | Click to toggle playback |
-| \`doubleClickToFullscreen\` | \`boolean\` | \`true\` | Double-click for fullscreen |
-
-> \`@remotion/player\` is a peer dependency. Install it in your app if you use \`DemoPlayer\`.
-
-## Remotion Studio
-
-The \`@contractspec/app.video-studio\` package provides a Remotion Studio entry point for previewing compositions interactively.
-
-\`\`\`bash
-# Start Remotion Studio
-bun run dev:video
-
-# Render a specific composition
-bunx remotionb render src/index.ts ApiOverview out/api-overview.mp4
-
-# Render all compositions
-bun run render:all
-\`\`\`
-
-### Registered Compositions
-
-| ID | Component | Dimensions | Duration | Description |
-|----|-----------|------------|----------|-------------|
-| \`ApiOverview\` | \`ApiOverview\` | 1920x1080 | 450 frames (15s) | Homepage API demo |
-| \`SocialClip\` | \`SocialClip\` | 1920x1080 | 300 frames (10s) | Landscape social clip |
-| \`SocialClipSquare\` | \`SocialClip\` | 1080x1080 | 300 frames (10s) | Square social clip |
-| \`SocialClipPortrait\` | \`SocialClip\` | 1080x1920 | 300 frames (10s) | Portrait social clip |
-| \`TerminalDemo\` | \`TerminalDemo\` | 1920x1080 | 600 frames (20s) | CLI walkthrough |
-
-All compositions run at 30fps.
-
-## Guardrails
-
-- \`LocalRenderer\` requires Node.js or Bun -- do not attempt to use it in browser environments. On Bun, SSR scripts may not auto-quit (see [Remotion Bun docs](https://www.remotion.dev/docs/bun)).
-- Import \`LocalRenderer\` from the \`/renderers/local\` subpath to avoid bundling \`@remotion/renderer\` in browser builds.
-- The \`remotion\` entry point (\`@contractspec/lib.video-gen/remotion\`) is a **side-effect module** that calls \`registerRoot()\`. Only import it from Remotion Studio or render scripts.
-- Use quality presets for consistency: \`draft\` for development, \`standard\` for CI, \`high\` for releases.
-`}];f(h);

package/dist/docs/video-gen.docblock.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/docs/video-gen.docblock.js

@@ -1,127 +0,0 @@
-// @bun
-import{registerDocBlocks as f}from"@contractspec/lib.contracts-spec/docs";var h=[{id:"docs.video-gen.overview",title:"Video Generation Library",summary:"Programmatic video generation with Remotion -- from content brief to rendered MP4 in a single pipeline.",kind:"reference",visibility:"public",route:"/docs/video-gen/overview",tags:["video","remotion","generation","content-pipeline"],owners:["@contractspec/lib.video-gen"],body:`# Video Generation Library
-
-\`@contractspec/lib.video-gen\` provides **programmatic video generation** using [Remotion](https://remotion.dev). It follows the same generator pattern as \`@contractspec/lib.content-gen\` and consumes provider contracts from \`@contractspec/lib.contracts-integrations/integrations/providers/video\`.
-
-## Architecture
-
-The library is organized into five layers, each buildable and testable independently:
-
-\`\`\`
-Content Brief
-    |
-    v
-Generators -----> ScenePlanner (brief -> scenes)
-    |              ScriptGenerator (brief -> narration)
-    |              VideoGenerator (orchestrator)
-    v
-Compositions ---> Primitives (AnimatedText, CodeBlock, Terminal, ...)
-    |              Full Compositions (ApiOverview, SocialClip, TerminalDemo)
-    v
-Design ---------> Tokens, Motion, Typography, Layouts
-    |
-    v
-Renderers ------> LocalRenderer (@remotion/renderer)
-                   DemoPlayer (@remotion/player, web embedding)
-\`\`\`
-
-### Layer Responsibilities
-
-| Layer | Import Path | Purpose |
-|-------|-------------|---------|
-| **Types** | \`@contractspec/lib.video-gen/types\` | VideoBrief, ScenePlan, GeneratedVideo, re-exported contract types |
-| **Design** | \`@contractspec/lib.video-gen/design\` | Video-optimized tokens, motion primitives, typography, layouts |
-| **Compositions** | \`@contractspec/lib.video-gen/compositions\` | Remotion components (primitives + full compositions) |
-| **Generators** | \`@contractspec/lib.video-gen/generators\` | VideoGenerator, ScenePlanner, ScriptGenerator |
-| **Renderers** | \`@contractspec/lib.video-gen/renderers\` | LocalRenderer, render config, quality presets |
-| **Player** | \`@contractspec/lib.video-gen/player\` | Embeddable DemoPlayer for web apps |
-| **Remotion** | \`@contractspec/lib.video-gen/remotion\` | Remotion Studio entry point (registerRoot) |
-
-## Getting Started
-
-### 1. Generate a video project from a content brief
-
-\`\`\`ts
-import { VideoGenerator } from "@contractspec/lib.video-gen/generators";
-import { VIDEO_FORMATS } from "@contractspec/lib.video-gen/types";
-import type { VideoBrief } from "@contractspec/lib.video-gen/types";
-
-const generator = new VideoGenerator({ fps: 30 });
-
-const brief: VideoBrief = {
-  content: {
-    title: "Ship APIs 10x Faster",
-    summary: "ContractSpec generates everything from a single spec.",
-    problems: ["Manual API maintenance", "Inconsistent surfaces"],
-    solutions: ["One spec, every surface", "Safe regeneration"],
-    callToAction: "Try ContractSpec",
-  },
-  format: VIDEO_FORMATS.landscape,
-  targetDurationSeconds: 30,
-};
-
-const project = await generator.generate(brief);
-\`\`\`
-
-### 2. Render to MP4
-
-\`\`\`ts
-import { LocalRenderer } from "@contractspec/lib.video-gen/renderers/local";
-
-const renderer = new LocalRenderer({
-  entryPoint: "./src/remotion/index.ts",
-});
-
-const result = await renderer.render(project, {
-  outputPath: "out/video.mp4",
-});
-\`\`\`
-
-### 3. Embed in a web app
-
-\`\`\`tsx
-import { DemoPlayer } from "@contractspec/lib.video-gen/player";
-
-<DemoPlayer
-  compositionId="ApiOverview"
-  inputProps={{ specName: "CreateUser", specCode: "..." }}
-  controls
-  autoPlay
-  loop
-/>
-\`\`\`
-
-## Contract Bridge
-
-The library consumes provider contracts defined in \`@contractspec/lib.contracts-integrations\`:
-
-| Contract | Purpose |
-|----------|---------|
-| \`VideoProvider\` | Renderer abstraction (local, Lambda, Cloud Run) |
-| \`VideoProject\` | Scene graph with format, fps, audio tracks |
-| \`RenderConfig\` / \`RenderResult\` | Codec, quality, output path, dimensions |
-| \`CompositionRegistry\` | Metadata for registered Remotion compositions |
-| \`VideoFormat\` | Landscape / portrait / square / custom dimensions |
-
-Types are re-exported from the main entry for convenience:
-
-\`\`\`ts
-import type { VideoProject, RenderConfig } from "@contractspec/lib.video-gen";
-\`\`\`
-
-## Deterministic by Default
-
-All generators support two modes:
-
-- **Without LLM**: Fully deterministic, template-based output. Same brief always produces the same video project.
-- **With LLM**: Richer scene planning and narration scripts via an optional \`LLMProvider\`. Falls back to deterministic on any failure.
-
-This matches the content-gen pattern: \`constructor({ llm? })\` -> \`generate(brief)\`.
-
-## Guardrails
-
-- Compositions must be **deterministic**: same props = same visual output.
-- Design tokens bridge from \`@contractspec/lib.design-system\` -- do not duplicate brand values.
-- \`LocalRenderer\` works with Node.js and Bun. On Bun, SSR scripts may not auto-quit (see [Remotion Bun docs](https://www.remotion.dev/docs/bun)).
-- The \`remotion\` entry point is a side-effect module (calls \`registerRoot\`) -- import it only from Remotion Studio or render scripts.
-`}];f(h);

package/dist/generators/index.d.ts

@@ -1,3 +0,0 @@
-export type { ScenePlannerOptions } from './scene-planner';
-export { ScenePlanner } from './scene-planner';
-export { VideoGenerator } from './video-generator';