id: https://nde.nl/ontology/hc/class/VideoChapterList
name: video_chapter_list_class
title: Video Chapter List Class
imports:
  - linkml:types
  - ../slots/cover
  - ../slots/has_chapter
  - ../slots/identified_by
  - ../slots/has_quantity
  - ../slots/has_score
  - ../slots/has_source
  - ../slots/generated_by
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  prov: http://www.w3.org/ns/prov#
default_prefix: hc
classes:
  VideoChapterList:
    class_uri: schema:ItemList
    description: 'A collection of chapters for a video.


      Groups all chapters for a video with metadata about the chapter set.


      Enables bulk operations on chapters:

      - Import/export of chapter lists

      - Validation of chapter coverage

      - Source tracking for entire chapter set

      '
    exact_mappings:
    - schema:ItemList
    slots:
    - has_chapter
    - generated_by
    - has_source
    - cover
    - has_quantity
    - has_score
    - identified_by
    slot_usage:
      identified_by:
        range: VideoIdentifier
        required: true
        inlined: true
        examples:
        - value: '{"has_code": "dQw4w9WgXcQ", "platform": "YouTube"}'
      has_chapter:
        range: VideoChapter
        multivalued: true
        required: true
        inlined_as_list: true
      has_quantity:
        range: integer
        required: false
        inlined: false # Fixed invalid inline for primitive type
        examples:
        - value:
            has_measurement_unit:
              has_type: CHAPTER
              has_symbol: chapters
      has_source:
        range: Source
        required: false
        inlined: true
        examples:
        - value:
            has_type: MANUAL
            has_label: Creator-defined chapters
        - value:
            has_type: YOUTUBE_AI
            has_label: YouTube Auto-Chapters
        - value:
            has_type: WHISPER_CHAPTERS
            has_label: Whisper Analysis
            has_description: Generated from transcript topic segmentation
      generated_by:
        description: 'Generation event capturing when and how the chapter list was created. MIGRATED 2026-01-19: Replaces chapters_generated_at slot (Rule 53).'
        range: GenerationEvent
        required: false
        inlined: true
        examples:
        - value:
            temporal_extent:
              begin_of_the_begin: '2024-01-15T10:30:00Z'
              end_of_the_end: '2024-01-15T10:30:00Z'
            has_provenance:
              has_agent:
                has_type: SOFTWARE
                has_name: YouTube Auto-Chapters
            has_description: AI-generated chapters from video analysis
        - value:
            temporal_extent:
              begin_of_the_begin: '2024-03-20T14:00:00Z'
            has_description: Manually created by content creator
      cover:
        range: boolean
        required: false
    annotations:
      specificity_score: 0.1
      specificity_rationale: Generic utility class/slot created during migration
      custodian_types: "['*']"