id: https://nde.nl/ontology/hc/class/ArchivalLibrary
name: ArchivalLibrary
title: Archival Library Type
imports:
  - linkml:types
  - ./OrganizationBranch
  - ./CollectionType
  - ../slots/has_or_had_custodian_type
  - ../slots/specificity_annotation
  - ../slots/has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
  - ../slots/is_or_was_related_to  # was: wikidata_alignment - migrated per Rule 53 (2026-01-15)
  - ./SpecificityAnnotation
  - ./TemplateSpecificityScore  # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)

  - ./TemplateSpecificityType

  - ./TemplateSpecificityTypes
  - ./WikidataAlignment
  - ./WikiDataEntry  # for is_or_was_related_to range (2026-01-15)
  - ./ArchivalLibraryRecordSetType
  - ../slots/is_branch_of
  - ../slots/has_or_had_type  # was: branch_type - migrated per Rule 53 (2026-01-17)
  - ./BranchType  # for has_or_had_type range (2026-01-17)
classes:
  ArchivalLibrary:
    is_a: OrganizationBranch
    class_uri: org:OrganizationalUnit
    description: "Library that is part of or associated with an archive, providing reference \nmaterials and published works\
      \ to support archival research.\n\n**Wikidata**: Q25504402\n\n**IMPORTANT: This is an OrganizationBranch, NOT a standalone\
      \ CustodianType**\n\nArchival libraries are organizational units (branches/sections) within a \nlarger Archive custodian.\
      \ They do NOT exist independently - they are always\nembedded within an archive organization.\n\n**Scope**:\nArchival\
      \ libraries (Archivbibliotheken) hold:\n- Reference works for archival research\n- Published guides and finding aids\n\
      - Local history publications\n- Genealogical reference materials\n- Legal and administrative handbooks\n- Periodicals\
      \ related to archive holdings\n\n**Organizational Context**:\nArchival libraries are typically:\n- Embedded within larger\
      \ archive organizations (as org:OrganizationalUnit)\n- Supporting the research mission of the parent archive\n- Providing\
      \ context for archival collections\n- Serving both staff and external researchers\n\n**Branch Relationship**:\n- Use\
      \ `is_branch_of` to link to the parent Archive custodian\n- Use `has_or_had_type` = BranchLibraryUnit for classification\n\n\
      **Related Types**:\n- Archive (Q166118) - Parent archive organization\n- SpecialCollection (Q4431094) - Specialized\
      \ library holdings\n- OrganizationBranch - Parent class for organizational units\n\n**Dual-Class Pattern**:\nThis class\
      \ represents the BRANCH type (the library unit within an archive).\nFor the collection type, see `ArchivalLibraryRecordSetType`\
      \ (rico:RecordSetType).\n\n**Ontological Alignment**:\n- **W3C ORG**: org:OrganizationalUnit (branch of parent archive)\n\
      - **Schema.org**: schema:Library (hybrid archive-library)\n- **RiC-O**: rico:CorporateBody (as agent)\n\n**Multilingual\
      \ Labels**:\n- de: Archivbibliothek\n- es: biblioteca de archivo\n- fr: bibliothèque liée à une institution conservant\
      \ des archives\n"
    slot_usage:
      has_or_had_type:
        range: BranchType
        required: true
        description: |
          Type of branch. For archival libraries, this should be BranchLibraryUnit.
          MIGRATED from branch_type (2026-01-17) per Rule 53.
        examples:
        - value: BranchLibraryUnit
          description: Archival library branch type
      is_branch_of:
        required: true
      has_or_had_custodian_type:
        equals_expression: '["hc:ArchiveOrganizationType", "hc:LibraryType"]'
    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
    slots:
    - has_or_had_custodian_type
    - specificity_annotation
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)