# ColonialStatus class
#
# Created per slot_fixes.yaml revision for: colonial
# Migration date: 2026-01-22
# Rule reference: Rule 53, Rule 56

id: https://nde.nl/ontology/hc/class/ColonialStatus
name: colonial_status_class
title: Colonial Status Class

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  dcterms: http://purl.org/dc/terms/
  skos: http://www.w3.org/2004/02/skos/core#

imports:
  - linkml:types
  - ../metadata
  - ../slots/has_or_had_label
  - ../slots/has_or_had_identifier
  - ../slots/temporal_extent
  - ./TimeSpan

default_prefix: hc

classes:
  ColonialStatus:
    class_uri: hc:ColonialStatus
    description: |
      Structured representation of colonial/territorial status for geographic coverage.
      
      **PURPOSE**:
      
      Models colonial territories and their historical status in archival finding aids.
      Captures both the geographic territory and its colonial relationship over time.
      
      **DESIGN RATIONALE**:
      
      Created per slot_fixes.yaml migration from simple `colonial` string slot to
      structured class with temporal and geographic context.
      
      The revision specifies:
      - `includes_or_included` + `GeoSpatialPlace` for territory geometry
      - `is_or_was_categorized_as` + `ColonialStatus` for categorization
      
      **USE CASES**:
      
      - Dutch East Indies archives (1602-1949)
      - Belgian Congo documentation
      - British Colonial Office records
      - Portuguese overseas territories
      
      **PROVENANCE CONSIDERATIONS**:
      
      Colonial status is historically contingent and politically sensitive.
      Always capture:
      - Time period of colonial relationship
      - Perspective (colonizer vs. colonized)
      - Modern-day geographic equivalent
      
    exact_mappings:
      - dcterms:spatial
    close_mappings:
      - schema:containedInPlace
    related_mappings:
      - skos:Concept
    
    slots:
      - has_or_had_label
      - has_or_had_identifier
      - temporal_extent
    
    attributes:
      territory_name:
        description: |
          Name of the colonial territory.
          
          Use the historical name as recorded in archival sources.
          Modern equivalents should be recorded in notes or linked via GeoSpatialPlace.
        range: string
        required: true
        examples:
          - value: "Dutch East Indies"
            description: Historical name for Indonesia under Dutch rule
          - value: "Belgian Congo"
            description: Historical name for DRC under Belgian rule
          - value: "British Malaya"
            description: Historical British colonial territories in Southeast Asia
      
      colonizing_power:
        description: |
          The colonizing nation or entity.
        range: string
        examples:
          - value: "Netherlands"
          - value: "Belgium"
          - value: "United Kingdom"
          - value: "Portugal"
          - value: "France"
      
      modern_equivalent:
        description: |
          Modern-day country or region corresponding to this colonial territory.
          
          Use ISO 3166-1 alpha-2 codes or full country names.
        range: string
        multivalued: true
        examples:
          - value: "ID"
            description: Indonesia (former Dutch East Indies)
          - value: "CD"
            description: Democratic Republic of Congo (former Belgian Congo)
          - value: "MY"
            description: Malaysia (part of former British Malaya)
      
      status_type:
        description: |
          Type of colonial relationship.
        range: string
        examples:
          - value: "colony"
          - value: "protectorate"
          - value: "mandate"
          - value: "overseas territory"
          - value: "dependency"
    
    slot_usage:
      has_or_had_label:
        description: |
          Display label for the colonial status.
          MIGRATION: Used for simple string representation of colonial territory name.
        range: string
        examples:
          - value: "Dutch East Indies (1602-1949)"
      
      temporal_extent:
        description: |
          Time period of colonial relationship.
          
          Use CIDOC-CRM TimeSpan for precise temporal modeling.
        range: TimeSpan
        inlined: true
        examples:
          - value:
              begin_of_the_begin: "1602-01-01"
              end_of_the_end: "1949-12-27"
            description: Dutch colonial period in Indonesia (VOC founding to sovereignty transfer)
    
    examples:
      - value:
          territory_name: "Dutch East Indies"
          colonizing_power: "Netherlands"
          modern_equivalent:
            - "ID"
          status_type: "colony"
          has_or_had_label: "Dutch East Indies (1602-1949)"
          temporal_extent:
            begin_of_the_begin: "1602-03-20"
            end_of_the_end: "1949-12-27"
        description: Dutch colonial Indonesia - VOC founding to sovereignty transfer
      
      - value:
          territory_name: "Suriname"
          colonizing_power: "Netherlands"
          modern_equivalent:
            - "SR"
          status_type: "colony"
          has_or_had_label: "Dutch Suriname (1667-1975)"
          temporal_extent:
            begin_of_the_begin: "1667-01-01"
            end_of_the_end: "1975-11-25"
        description: Dutch colonial Suriname
      
      - value:
          territory_name: "Netherlands Antilles"
          colonizing_power: "Netherlands"
          modern_equivalent:
            - "CW"
            - "SX"
            - "BQ"
          status_type: "overseas territory"
          has_or_had_label: "Netherlands Antilles (1954-2010)"
          temporal_extent:
            begin_of_the_begin: "1954-01-01"
            end_of_the_end: "2010-10-10"
        description: Former Netherlands Antilles (now Curaçao, Sint Maarten, Caribbean Netherlands)
    
    comments:
      - Created per slot_fixes.yaml migration from colonial slot (2026-01-22)
      - Models colonial territories with temporal and geographic context
      - Supports decolonization research and provenance tracking
      - Politically sensitive - capture multiple perspectives where relevant
    
    see_also:
      - https://www.nationaalarchief.nl/onderzoeken/colonial-records
      - https://www.kit.nl/project/decolonization-heritage/