id: https://nde.nl/ontology/hc/class/ArchivalLibrary
name: ArchivalLibrary
title: Archival Library Type

imports:
  - linkml:types
  - ./OrganizationBranch
  - ./CollectionType

classes:
  ArchivalLibrary:
    is_a: OrganizationBranch
    class_uri: org:OrganizationalUnit
    annotations:
      custodian_types: '["A", "L"]'
      custodian_types_rationale: "Archival library is an OrganizationBranch combining archive (A) and library (L) functions."
    description: |
      Library that is part of or associated with an archive, providing reference 
      materials and published works to support archival research.
      
      **Wikidata**: Q25504402
      
      **IMPORTANT: This is an OrganizationBranch, NOT a standalone CustodianType**
      
      Archival libraries are organizational units (branches/sections) within a 
      larger Archive custodian. They do NOT exist independently - they are always
      embedded within an archive organization.
      
      **Scope**:
      Archival libraries (Archivbibliotheken) hold:
      - Reference works for archival research
      - Published guides and finding aids
      - Local history publications
      - Genealogical reference materials
      - Legal and administrative handbooks
      - Periodicals related to archive holdings
      
      **Organizational Context**:
      Archival libraries are typically:
      - Embedded within larger archive organizations (as org:OrganizationalUnit)
      - Supporting the research mission of the parent archive
      - Providing context for archival collections
      - Serving both staff and external researchers
      
      **Branch Relationship**:
      - Use `is_branch_of` to link to the parent Archive custodian
      - Use `branch_type` = BRANCH_LIBRARY for classification
      
      **Related Types**:
      - Archive (Q166118) - Parent archive organization
      - SpecialCollection (Q4431094) - Specialized library holdings
      - OrganizationBranch - Parent class for organizational units
      
      **Dual-Class Pattern**:
      This class represents the BRANCH type (the library unit within an archive).
      For the collection type, see `ArchivalLibraryRecordSetType` (rico:RecordSetType).
      
      **Ontological Alignment**:
      - **W3C ORG**: org:OrganizationalUnit (branch of parent archive)
      - **Schema.org**: schema:Library (hybrid archive-library)
      - **RiC-O**: rico:CorporateBody (as agent)
      
      **Multilingual Labels**:
      - de: Archivbibliothek
      - es: biblioteca de archivo
      - fr: bibliothèque liée à une institution conservant des archives
    
    slot_usage:
      branch_type:
        description: |
          MUST be 'BRANCH_LIBRARY' for ArchivalLibrary instances.
          Indicates this is a library unit within an archive organization.
        equals_string: "BRANCH_LIBRARY"
        required: true
      
      is_branch_of:
        description: |
          Reference to the parent Archive custodian.
          All ArchivalLibrary instances MUST be linked to a parent archive.
        required: true
    
    # DOCUMENTATION NOTES (not slot_usage - these slots are not inherited):
    # wikidata_entity: Should be Q25504402 for this type (hybrid archive-library function)
    # record_types: Typically includes reference books, published finding aids,
    #   local history publications, genealogical materials, periodicals.
    
    exact_mappings:
      - org:OrganizationalUnit
    close_mappings:
      - schema:Library
      - schema:ArchiveOrganization
      - rico:CorporateBody
    
    comments:
      - "BRANCH type: Archival library is a section WITHIN an archive, not standalone"
      - "Uses org:OrganizationalUnit pattern from W3C ORG ontology"
      - "Part of dual-class pattern: branch type + rico:RecordSetType"
      - "Holdings are primarily published works, not archival records"
      - "ALWAYS linked to parent Archive via is_branch_of"
    
    see_also:
      - SpecialCollection
      - OrganizationBranch

  # rico:RecordSetType for collection classification
  ArchivalLibraryRecordSetType:
    description: >-
      A rico:RecordSetType for classifying collections of archival library
      materials within heritage institutions.
    is_a: CollectionType
    class_uri: rico:RecordSetType
    slot_usage:
      wikidata_equivalent:
        equals_string: "Q25504402"
    see_also:
      - ArchivalLibrary
    annotations:
      wikidata: Q25504402
      linked_custodian_type: ArchivalLibrary