# WikiDataEntry class
# Reference to a Wikidata entity for alignments and equivalences
#
# Generation date: 2026-01-15
# Rule compliance: 0 (LinkML single source of truth), 38 (slot centralization), 53 (slot_fixes.yaml)
#
# This class supports 5 slot migrations per slot_fixes.yaml:
# - wikidata_mapping
# - wikidata_equivalent
# - wikidata_class
# - wikidata_alignment
# - wikidata
#
# NOTE: Similar to WikidataEntity but designed as migration target for slot_fixes.yaml

id: https://nde.nl/ontology/hc/class/WikiDataEntry
name: wikidata_entry_class
title: WikiDataEntry Class

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  wikibase: http://wikiba.se/ontology#
  wd: http://www.wikidata.org/entity/
  schema: http://schema.org/
  skos: http://www.w3.org/2004/02/skos/core#
  prov: http://www.w3.org/ns/prov#

default_prefix: hc

imports:
  - linkml:types
  - ../metadata
  # RiC-O style generic slots - migrated 2026-01-16 per Rule 53
  - ../slots/has_or_had_identifier     # was: wikidata_qid
  - ../slots/has_or_had_label          # was: wikidata_label
  - ../slots/has_or_had_description    # was: wikidata_description
  - ../slots/language
  - ../slots/specificity_annotation
  - ../slots/has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
  - ./SpecificityAnnotation
  - ./TemplateSpecificityScore  # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)

  - ./TemplateSpecificityType

  - ./TemplateSpecificityTypes

classes:
  WikiDataEntry:
    class_uri: wikibase:Item
    description: |
      Reference to a Wikidata entity (Q-item) for alignments and equivalences.
      
      **Purpose**:
      WikiDataEntry provides a reusable class for representing Wikidata entity
      references with Q-number identifier, label, and description.
      Used for ontology alignments, equivalence mappings, and classification.
      
      **Ontological Alignment**:
      - **Primary**: `wikibase:Item` - Wikibase item class
      - **Close**: `schema:Thing` - general web entity
      - **Related**: `skos:Concept` - controlled vocabulary concept
      
      **Use Cases**:
      - Ontology alignment: `wikidata_alignment` → relates schema class to Wikidata Q
      - Equivalence: `wikidata_equivalent` → marks semantic equivalence
      - Classification: `wikidata_class` → instance_of relationship
      - General mapping: `wikidata_mapping` → related concept
      
      **Replaces** (per slot_fixes.yaml):
      - `wikidata_mapping` (string Q-number)
      - `wikidata_equivalent` (string Q-number)
      - `wikidata_class` (string Q-number)
      - `wikidata_alignment` (string Q-number)
      - `wikidata` (string Q-number)
      
    exact_mappings:
      - wikibase:Item
    
    close_mappings:
      - schema:Thing
    
    related_mappings:
      - skos:Concept
      - prov:Entity
    
    slots:
      - has_or_had_identifier      # was: wikidata_qid - migrated 2026-01-16 per Rule 53
      - has_or_had_label           # was: wikidata_label - migrated 2026-01-16 per Rule 53
      - has_or_had_description     # was: wikidata_description - migrated 2026-01-16 per Rule 53
      - language
      - specificity_annotation
      - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    
    slot_usage:
      has_or_had_identifier:  # was: wikidata_qid - migrated 2026-01-16 per Rule 53
        description: |
          The Wikidata Q-number identifier (e.g., Q12345).
          For WikiDataEntry, this is the primary Q-ID reference.
        range: string
        required: true
        pattern: "^Q[0-9]+$"
      has_or_had_label:  # was: wikidata_label - migrated 2026-01-16 per Rule 53
        description: |
          Human-readable label from Wikidata.
        range: string
        required: false
      has_or_had_description:  # was: wikidata_description - migrated 2026-01-16 per Rule 53
        description: |
          Description from Wikidata.
        range: string
        required: false
      language:
        description: |
          Language code for the label and description.
          Default: "en"
        range: string
        required: false
        pattern: "^[a-z]{2}(-[A-Z]{2})?$"
    
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: Generic Wikidata reference class applicable to all types.
      custodian_types_primary: null
      specificity_score: 0.2
      specificity_rationale: Broadly applicable generic class for Wikidata links.
    
    examples:
      - value: |
          has_or_had_identifier: "Q33506"
          has_or_had_label: "museum"
          has_or_had_description: "institution that holds and displays collections"
          language: en
        description: "Wikidata reference for 'museum' concept"
      - value: |
          has_or_had_identifier: "Q190804"
          has_or_had_label: "Rijksmuseum"
          has_or_had_description: "Dutch national museum in Amsterdam"
          language: en
        description: "Wikidata reference for specific institution"