id: https://nde.nl/ontology/hc/class/VideoChapterList
name: video_chapter_list_class
title: Video Chapter List Class
imports:
- linkml:types
- ./VideoChapter
- ../slots/specificity_annotation
- ./SpecificityAnnotation
- ../slots/template_specificity
- ./TemplateSpecificityScores
- ../enums/ChapterSourceEnum
# REMOVED - migrated to has_or_had_identifier with VideoIdentifier (2026-01-14, Rule 53)
# - ../slots/video_id
- ../slots/has_or_had_identifier
- ./VideoIdentifier
- ../slots/has_or_had_chapter
# REMOVED 2026-01-14: ../slots/total_chapter - migrated to has_or_had_quantity with Quantity
- ../slots/has_or_had_quantity
- ./Quantity
- ../slots/chapters_source
- ../slots/chapters_generated_at
- ../slots/covers_full_video
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_or_had_chapter
    - chapters_generated_at
    - chapters_source
    - covers_full_video
    - has_or_had_quantity  # ADDED 2026-01-14: replaces total_chapter
    - specificity_annotation
    - template_specificity
    # REMOVED 2026-01-14: total_chapter - migrated to has_or_had_quantity
    # REMOVED - migrated to has_or_had_identifier (2026-01-14, Rule 53)
    # - video_id
    - has_or_had_identifier
    slot_usage:
      # MIGRATED from video_id (2026-01-14, Rule 53)
      # video_id:
      #   range: string
      #   required: true
      has_or_had_identifier:
        description: Reference to the parent video
        range: VideoIdentifier
        required: true
        inlined: true
        examples:
        - value: '{"has_or_had_code": "dQw4w9WgXcQ", "platform": "YouTube"}'
          description: YouTube video identifier
      has_or_had_chapter:
        range: VideoChapter
        multivalued: true
        required: true
        inlined_as_list: true
      # REMOVED 2026-01-14: total_chapter - migrated to has_or_had_quantity
      # total_chapter:
      #   range: integer
      #   required: false
      #   minimum_value: 0
      has_or_had_quantity:
        range: Quantity
        required: false
        inlined: true
        description: |
          Total number of chapters in this list.
          MIGRATED 2026-01-14: Replaces total_chapter slot.
        examples:
        - value:
            quantity_value: 12
            quantity_type: CHAPTER_COUNT
            has_or_had_measurement_unit:
              unit_type: CHAPTER
              unit_symbol: "chapters"
          description: 12 chapters in this video
      chapters_source:
        range: ChapterSourceEnum
        required: false
      chapters_generated_at:
        range: datetime
        required: false
      covers_full_video:
        range: boolean
        required: false