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
  - ../slots/video_id
  - ../slots/has_or_had_chapter
  - ../slots/total_chapter
  - ../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
      - specificity_annotation
      - template_specificity
      - total_chapter
      - video_id
    slot_usage:
      video_id:
        slot_uri: schema:isPartOf
        description: Reference to the parent video
        range: string
        required: true
      has_or_had_chapter:
        slot_uri: schema:itemListElement
        description: Ordered list of chapters
        range: VideoChapter
        multivalued: true
        required: true
        inlined_as_list: true
      total_chapter:
        slot_uri: hc:totalChapters
        description: Total number of chapters
        range: integer
        required: false
        minimum_value: 0
      chapters_source:
        slot_uri: prov:wasAttributedTo
        description: Primary source for this chapter list
        range: ChapterSourceEnum
        required: false
      chapters_generated_at:
        slot_uri: prov:generatedAtTime
        description: When chapters were generated/extracted
        range: datetime
        required: false
      covers_full_video:
        slot_uri: hc:coversFullVideo
        description: |
          Whether chapters cover the entire video duration.

          - true: No gaps, first chapter at 0:00, last ends at video end
          - false: Partial coverage (gaps between chapters)
        range: boolean
        required: false
      specificity_annotation:
        range: SpecificityAnnotation
        inlined: true
      template_specificity:
        range: TemplateSpecificityScores
        inlined: true