# =============================================================================
# APPELLATION Hypernym Module
# =============================================================================
# Version: 1.7.0
# Module: hypernyms/app.yaml
# 
# BREAKING CHANGE v1.7.0: Renamed from DENOMINATION (DEN) to APPELLATION (APP)
# and restructured to separate:
#   - APPELLATION: Names as linguistic constructs (titles, collection names)
#   - ROLE: Social/occupational positions (see rol.yaml)
# 
# TEI P5 provides the authority: <name>, <title>, <roleName>, <occupation>
# are distinct element types, not conflated.
# =============================================================================

id: hypernym_appellation
name: "APPELLATION Hypernym"
description: |
  Naming constructs as linguistic entities, distinct from the things they name.
  Appellations are linguistic labels that identify entities.

hypernym:
  APPELLATION:
    code: "APP"
    definition: |
      Naming constructs as linguistic entities, distinct from the things they
      name. Appellations are linguistic labels that identify entities:
      - Titles (artwork titles, document titles)
      - Collection names (archival fonds, named collections)
      - Exhibition names (named temporary displays)
      - Awards (named honors and prizes)
      - Structured person names (when analyzing name components)
      
      For ROLES (positions, occupations, honorifics), see the ROLE hypernym.
    
    design_rationale: |
      CIDOC-CRM E41 Appellation: "This class comprises signs, either meaningful
      or not, or arrangements of signs following a specific syntax, that are
      used or can be used to refer to and identify a specific instance."
      
      Appellations are DISTINCT from what they name:
      - "The Night Watch" (appellation) vs. the painting (E22_Human-Made_Object)
      - "Rembrandt van Rijn" (appellation) vs. the person (E21_Person)
      
      TEI P5 uses:
      - <name> for any naming string
      - <persName> for person names (with sub-elements)
      - <placeName> for place names
      - <title> for work titles
      - <roleName> for role designations (see ROLE hypernym)
    
    ontology_mappings:
      primary_class: "crm:E41_Appellation"
      primary_class_definition: |
        CIDOC-CRM E41 Appellation: "This class comprises signs, either meaningful
        or not, or arrangements of signs following a specific syntax, that are
        used or can be used to refer to and identify a specific instance."
      alternative_classes:
        - "skos:prefLabel"
        - "rdfs:label"
        - "rico:Name"
      linkml_mapping:
        class_uri: "crm:E41_Appellation"
        exact_mappings: []
        close_mappings:
          - "skos:prefLabel"
          - "rdfs:label"
      nerd_class: null
      nerd_note: |
        NERD has no dedicated class for names/appellations. Appellation entities
        are linguistic constructs that name other entities. In NIF export, these
        become nif:Phrase instances without a specific NERD type.
      pnv_class: "pnv:PersonName"
      pnv_note: |
        For person names, use PNV (Person Name Vocabulary) structured representation
        with components: pnv:givenName, pnv:surnamePrefix, pnv:baseSurname, pnv:patronym
    
    subcategories:
      TITLE:
        code: "APP.TIT"
        definition: "Titles of artworks, books, documents, musical works"
        examples:
          - "The Night Watch"
          - "Girl with a Pearl Earring"
          - "On the Origin of Species"
          - "Symphony No. 9"
        ontology_class: "crm:E35_Title"
        linkml_mapping:
          class_uri: "crm:E35_Title"
        note: |
          Titles are appellations for Works (see WORK hypernym).
          The same work may have multiple titles (original, translated, popular).
      
      COLLECTION:
        code: "APP.COL"
        definition: "Named collections and archival fonds"
        examples:
          - "the Golden Age Collection"
          - "Archief van de Familie Bicker"
          - "Dutch Masters Collection"
          - "Fonds Bicker"
        ontology_class: "rico:RecordSet"
        alternative_classes:
          - "crm:E78_Curated_Holding"
        note: |
          Collection names identify aggregations of objects.
          Use rico:RecordSet for archival fonds/series.
          Use crm:E78_Curated_Holding for museum collections.
      
      EXHIBITION:
        code: "APP.EXH"
        definition: "Named exhibitions and displays"
        examples:
          - "Rembrandt and the Golden Age"
          - "Vermeer: Master of Light"
          - "The Art of Living (2023)"
        ontology_class: "crm:E7_Activity"
        alternative_classes:
          - "schema:ExhibitionEvent"
        note: |
          Exhibition names are appellations for events (E7_Activity).
          Include dates when analyzing exhibition history.
      
      AWARD:
        code: "APP.AWD"
        definition: "Named prizes, honors, and awards"
        examples:
          - "Nobel Prize in Physics"
          - "Rijksmuseum Award"
          - "Order of Orange-Nassau"
          - "Pulitzer Prize"
        ontology_class: "crm:E55_Type"
        note: |
          Awards are types that can be bestowed. The bestowal event
          is an E7_Activity; the award type is the appellation.
      
      PERSONNAME:
        code: "APP.PNM"
        definition: |
          Structured person name components, for detailed name analysis.
          Use when parsing name parts, not for simple person mentions.
        examples:
          - "van Rijn (surname prefix + surname)"
          - "Rembrandt Harmenszoon (given name + patronym)"
          - "Dr. Maria van den Berg, PhD"
        ontology_class: "pnv:PersonName"
        pnv_components:
          givenName: "pnv:givenName"
          patronym: "pnv:patronym"
          surnamePrefix: "pnv:surnamePrefix"
          baseSurname: "pnv:baseSurname"
          honorificPrefix: "pnv:honorificPrefix (Dr., Prof.)"
          honorificSuffix: "pnv:honorificSuffix (PhD, Jr.)"
        note: |
          Use APP.PNM when analyzing name structure (genealogy, prosopography).
          For simple person mentions, use AGENT.PER.
          Honorifics in names are part of the appellation, not separate roles.
    
    inclusion_rules:
      - id: "APP_INC001"
        rule: "Tag work titles in their original language when possible"
        examples:
          - "De Nachtwacht (Dutch)"
          - "The Night Watch (English translation)"
      
      - id: "APP_INC002"
        rule: "Tag collection names including archival fonds designations"
        examples:
          - "Fonds Bicker"
          - "Collection Fodor"
      
      - id: "APP_INC003"
        rule: "Tag exhibition titles with dates when given"
        examples:
          - "Vermeer (2023)"
          - "Rembrandt: The Late Works (2015)"
    
    exclusion_rules:
      - id: "APP_EXC001"
        rule: "Do NOT tag generic descriptive phrases"
        examples:
          - "the painting (not a title)"
          - "the exhibition (not named)"
      
      - id: "APP_EXC002"
        rule: "Do NOT double-tag: if tagged as AGENT/GROUP, do not also tag as APPELLATION"
        note: "Exception: when specifically analyzing name structure (APP.PNM)"
      
      - id: "APP_EXC003"
        rule: "Do NOT tag roles/occupations as appellations (use ROLE hypernym)"
        examples:
          - "Director (use ROLE.OCC)"
          - "Curator (use ROLE.OCC)"
          - "His Majesty (use ROLE.HON)"