# SourceReference - Structured source reference for a claim
# Extracted from custodian_source.yaml per Rule 38 (modular schema files)
# Extraction date: 2026-01-08

id: https://nde.nl/ontology/hc/classes/SourceReference
name: SourceReference
title: SourceReference

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  prov: http://www.w3.org/ns/prov#
  xsd: http://www.w3.org/2001/XMLSchema#
  oa: http://www.w3.org/ns/oa#
  dcterms: http://purl.org/dc/terms/

imports:
  - linkml:types


default_range: string

classes:
  SourceReference:
      description: >-
        Structured source reference for a claim with text position information
        including excerpts, character offsets, and relevance scores.
        
        Ontology mapping rationale:
        - class_uri is oa:TextPositionSelector because this class specifies
          exact text positions (char_start, char_end) within a source document
        - close_mappings includes prov:PrimarySource as it references source material
        - close_mappings includes dcterms:BibliographicResource for citation context
        - related_mappings includes schema:Quotation for text excerpt functionality
      class_uri: oa:TextPositionSelector
      close_mappings:
        - prov:PrimarySource
        - dcterms:BibliographicResource
      related_mappings:
        - schema:Quotation
      attributes:
        source_id:
          range: string
          description: Unique identifier for this source reference
        text_excerpt:
          range: string
          description: Text excerpt from the source
        char_start:
          range: integer
          description: Start character position
        char_end:
          range: integer
          description: End character position
        markdown_heading_path:
          range: string
          description: Path of markdown headings to this content
        sentence_index:
          range: integer
          description: Index of sentence within the document
        exa_highlight_index:
          range: integer
          description: Index of the Exa highlight match
        relevance_score:
          range: float
          description: Relevance score from search engine (0-1)