{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://timmy-foundation/scene-description/v1",
  "title": "Scene Description Entry",
  "description": "A single lyrics-to-visual scene description beat from a song.",
  "type": "object",
  "required": ["song", "artist", "beat", "timestamp", "duration_seconds", "lyric_line", "scene"],
  "properties": {
    "song": {
      "type": "string",
      "minLength": 1,
      "description": "Song title"
    },
    "artist": {
      "type": "string",
      "minLength": 1,
      "description": "Artist name (may be fictional)"
    },
    "beat": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Beat number within the song (1-indexed)"
    },
    "timestamp": {
      "type": "string",
      "pattern": "^[0-9]{1,2}:[0-9]{2}$",
      "description": "Timestamp in M:SS or MM:SS format"
    },
    "duration_seconds": {
      "type": "integer",
      "minimum": 1,
      "maximum": 600,
      "description": "Duration of this beat in seconds"
    },
    "lyric_line": {
      "type": "string",
      "minLength": 1,
      "description": "The lyric line for this beat"
    },
    "scene": {
      "type": "object",
      "required": ["mood", "colors", "composition", "camera", "description"],
      "properties": {
        "mood": {
          "type": "string",
          "minLength": 1,
          "description": "Emotional mood of this beat"
        },
        "colors": {
          "type": "array",
          "minItems": 1,
          "maxItems": 5,
          "items": {
            "type": "string",
            "minLength": 1
          },
          "description": "Color palette for this scene (1-5 colors)"
        },
        "composition": {
          "type": "string",
          "minLength": 1,
          "description": "Camera composition (e.g., wide shot, close-up, low angle)"
        },
        "camera": {
          "type": "string",
          "minLength": 1,
          "description": "Camera movement (e.g., slow zoom, steady hold, pan right)"
        },
        "description": {
          "type": "string",
          "minLength": 10,
          "description": "Full visual scene description (min 10 chars)"
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}