# TextDirection class
# Represents the directional orientation of text flow in information carriers
#
# Created: 2026-01-16
# Migration: text_direction slot → has_or_had_direction + TextDirection (Rule 53/56)
# Rule compliance: 0b (Type/Types pattern), 38, 39, 53

id: https://nde.nl/ontology/hc/class/TextDirection
name: TextDirection
title: Text Direction Class

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  crm: http://www.cidoc-crm.org/cidoc-crm/
  skos: http://www.w3.org/2004/02/skos/core#

default_prefix: hc

imports:
  - linkml:types
  - ../metadata
  - ../slots/has_or_had_label
  - ../slots/has_or_had_code

classes:
  TextDirection:
    class_uri: hc:TextDirection
    description: |
      The directional orientation of text flow on an information carrier.
      
      **Purpose**:
      Captures how text is read/written on manuscripts, inscriptions, and other
      information carriers. Essential for proper display and understanding of
      historical documents from different writing traditions.
      
      **Common Directions**:
      
      | Direction | Scripts | Example |
      |-----------|---------|---------|
      | LEFT_TO_RIGHT | Latin, Cyrillic, Greek | Modern European books |
      | RIGHT_TO_LEFT | Arabic, Hebrew, Syriac | Quran manuscripts, Torah scrolls |
      | TOP_TO_BOTTOM | Traditional CJK | Classical Chinese scrolls |
      | BOUSTROPHEDON | Ancient Greek, Etruscan | "Ox-turning" alternating lines |
      
      **Relationship to WritingSystem**:
      TextDirection is distinct from WritingSystem (ISO 15924 script codes).
      A single script may have multiple historical or regional direction conventions.
      
      **Usage**:
      Used with `has_or_had_direction` slot in InformationCarrier and similar classes.
      
      **Migrated From**: text_direction string slot (2026-01-16) per Rule 53/56
    slots:
      - has_or_had_label
      - has_or_had_code
    slot_usage:
      has_or_had_label:
        description: Human-readable label for the text direction (e.g., "Left to Right", "Right to Left")
        examples:
          - value: "Left to Right"
          - value: "Right to Left"
          - value: "Top to Bottom"
      has_or_had_code:
        description: |
          Short code for the text direction.
          Common codes: LTR, RTL, TTB, BTT, BOUSTROPHEDON
        examples:
          - value: "LTR"
            description: Left to right
          - value: "RTL"
            description: Right to left (Arabic, Hebrew)
          - value: "TTB"
            description: Top to bottom (traditional CJK)
          - value: "BOUSTROPHEDON"
            description: Alternating direction
    annotations:
      custodian_types: '["L", "A", "M", "R", "H"]'
      custodian_types_rationale: Relevant to libraries, archives, museums, research centers, and holy sites holding manuscripts
      specificity_score: 0.45
      specificity_rationale: Moderately specific class for manuscript/document analysis
    examples:
      - value:
          has_or_had_code: "LTR"
          has_or_had_label: "Left to Right"
        description: Standard Western European text direction
      - value:
          has_or_had_code: "RTL"
          has_or_had_label: "Right to Left"
        description: Arabic or Hebrew manuscript text direction
      - value:
          has_or_had_code: "TTB"
          has_or_had_label: "Top to Bottom"
        description: Traditional Chinese/Japanese vertical writing
      - value:
          has_or_had_code: "BOUSTROPHEDON"
          has_or_had_label: "Boustrophedon"
        description: Ancient alternating direction (lines alternate LTR and RTL)