# TextSegment - Text segment/fragment class
#
# Created per slot_fixes.yaml migration for: xpath_matched_text
# Creation date: 2026-01-14

id: https://nde.nl/ontology/hc/class/TextSegment
name: TextSegment
title: Text Segment

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  oa: http://www.w3.org/ns/oa#

default_prefix: hc

imports:
  - linkml:types
  - ../slots/has_or_had_text

classes:
  TextSegment:
    class_uri: oa:TextualBody
    description: |
      A segment or fragment of text extracted from a source.
      
      **USAGE**:
      Used for:
      - XPath matched text
      - Extracted text fragments
      - Annotation bodies
      
    slots:
      - has_or_had_text
    
    attributes:
      source_xpath:
        range: string
        description: XPath expression that selected this text
      
      start_offset:
        range: integer
        description: Character offset where segment starts
      
      end_offset:
        range: integer
        description: Character offset where segment ends
    
    exact_mappings:
      - oa:TextualBody
    
    annotations:
      specificity_score: "0.50"
      specificity_rationale: "Moderately specific - text extraction common in web scraping."
    
    examples:
      - value:
          has_or_had_text: "The museum collection includes..."
          source_xpath: "//div[@class='content']/p[1]"
        description: Text segment from webpage