meta:
  title: "string - descriptive title"
  duration: "string - total duration (e.g. 60s)"
  type: "enum - demo | explainer | social | announcement"
  resolution: "string - e.g. 3840x2160, 1920x1080"
  fps: "number - 24, 30, or 60"
  audience: "string - who is watching"
  tone: "string - comma-separated descriptors"
  total_frames: "number - duration_seconds * fps"

scenes:
  - id: "string - unique kebab-case identifier"
    duration: "string - e.g. 4s, 8s"
    frames: "number - scene_duration_seconds * fps"
    narration: "string - max 15 words per sentence"
    visual: "string - what the viewer sees on screen"
    animation: "string - how elements move, with frame references"
    music:
      track: "string - music track name"
      volume: "number - 0.0 to 1.0"
      duck: "boolean - lower music during narration"
    sfx:
      - type: "string - sound effect name"
        at: "string - timestamp within scene"
        duration: "string - how long it plays"
    transition_to_next: "enum - hard-cut | cross-dissolve | fade-to-black | wipe-left | wipe-right | none"

total_frames = duration_seconds * fps
scene_frames = scene_duration_seconds * fps
Example: 60s video at 30fps = 1800 total frames

meta:
  title: "Product Demo - Acme Dashboard"
  duration: "60s"
  type: demo
  resolution: 3840x2160
  fps: 30
  audience: "SaaS founders and product managers"
  tone: "professional, confident, minimal"
  total_frames: 1800

scenes:
  - id: intro
    duration: "4s"
    frames: 120
    narration: "Meet Acme - the dashboard that builds itself."
    visual: "Logo centered on warm off-white background, fades in from transparent"
    animation: "fade-in over 30 frames, hold for 90 frames"
    music:
      track: "upbeat-corporate"
      volume: 0.4
      duck: false
    sfx: []
    transition_to_next: "hard-cut"

  - id: feature-1
    duration: "8s"
    frames: 240
    narration: "Just describe what you need. Acme handles the rest."
    visual: "Browser mockup showing prompt input, text being typed"
    animation: "browser slides up from bottom over 20 frames, typing starts at frame 40"
    music:
      track: "upbeat-corporate"
      volume: 0.2
      duck: true
    sfx:
      - type: "keyboard-typing"
        at: "1.3s"
        duration: "3s"
    transition_to_next: "cross-dissolve"

  - id: feature-2
    duration: "8s"
    frames: 240
    narration: "Drag, drop, resize. Your layout, your rules."
    visual: "Dashboard editor with widgets being rearranged by cursor"
    animation: "cursor moves to widget at frame 30, drags to new position over 60 frames"
    music:
      track: "upbeat-corporate"
      volume: 0.2
      duck: true
    sfx:
      - type: "soft-click"
        at: "1.0s"
        duration: "0.2s"
    transition_to_next: "cross-dissolve"

  - id: cta
    duration: "6s"
    frames: 180
    narration: "Try Acme free at acme.dev. Build your first dashboard in minutes."
    visual: "CTA text centered with URL, subtle animated background gradient"
    animation: "text fades in over 20 frames, background gradient shifts slowly"
    music:
      track: "upbeat-corporate"
      volume: 0.4
      duck: false
    sfx: []
    transition_to_next: "fade-to-black"

meta:
  title: "Acme in 30 Seconds"
  duration: "30s"
  type: social
  resolution: 1080x1920
  fps: 30
  audience: "Developers scrolling social feeds"
  tone: "energetic, punchy, modern"
  total_frames: 900

scenes:
  - id: hook
    duration: "3s"
    frames: 90
    narration: "Stop building dashboards from scratch."
    visual: "Bold text on vibrant gradient background"
    animation: "text slams in from top over 8 frames, screen shakes for 4 frames"
    music:
      track: "electronic-pulse"
      volume: 0.5
      duck: true
    sfx:
      - type: "impact-hit"
        at: "0.2s"
        duration: "0.3s"
    transition_to_next: "hard-cut"

  - id: demo
    duration: "12s"
    frames: 360
    narration: "Type what you need. Acme builds it live."
    visual: "Screen recording: typing a prompt, dashboard generating in real time"
    animation: "typing for 120 frames, dashboard builds over remaining 240 frames"
    music:
      track: "electronic-pulse"
      volume: 0.3
      duck: true
    sfx:
      - type: "keyboard-typing"
        at: "0.5s"
        duration: "4s"
    transition_to_next: "hard-cut"

  - id: result
    duration: "8s"
    frames: 240
    narration: "Fully interactive. Real-time data. Ready to share."
    visual: "Finished dashboard with hover interactions, data updating live"
    animation: "cursor hovers triggering tooltips, data refreshes at frame 120"
    music:
      track: "electronic-pulse"
      volume: 0.3
      duck: true
    sfx: []
    transition_to_next: "hard-cut"

  - id: cta
    duration: "7s"
    frames: 210
    narration: "Try free at acme.dev."
    visual: "CTA text large and centered, URL below, brand gradient background"
    animation: "text scales up from 0 to full size over 15 frames, holds"
    music:
      track: "electronic-pulse"
      volume: 0.5
      duck: false
    sfx: []
    transition_to_next: "none"

Input:  duration = 60s, fps = 30
Output: total_frames = 1800

Scene breakdown:
  intro:     4s * 30 = 120 frames
  feature-1: 8s * 30 = 240 frames
  feature-2: 8s * 30 = 240 frames
  proof:     6s * 30 = 180 frames
  cta:       6s * 30 = 180 frames
  ---
  Sum: 32s = 960 frames (remaining 840 frames need more scenes)

undefined

---