<?php

declare(strict_types=1);

namespace Drupal\site_structure\Plugin\ParentEntityHandler;

use Drupal\Core\Breadcrumb\Breadcrumb;
use Drupal\Core\Entity\EntityInterface;
use Drupal\Core\StringTranslation\TranslatableMarkup;
use Drupal\site_structure\Attribute\ParentEntityHandler;
use Drupal\site_structure\ParentEntityHandler\ParentEntityHandlerBase;
use Drupal\taxonomy\TermInterface;

/**
 * Handler for taxonomy term entities.
 */
#[ParentEntityHandler(
  id: 'taxonomy_term',
  label: new TranslatableMarkup('Taxonomy Vocabularies (taxonomy_term)'),
  entity_type_id: 'taxonomy_term',
  clears_site_section: FALSE,
  sort_field: 'name',
  bundle_restrictions: ['site_section'],
  weight: 0,
)]
class TaxonomyTermHandler extends ParentEntityHandlerBase {

  /**
   * {@inheritdoc}
   */
  public function getEntityFromRoute(\Drupal\Core\Routing\RouteMatchInterface $route_match): ?EntityInterface {
    $term = $route_match->getParameter('taxonomy_term');

    if (!$term instanceof TermInterface) {
      return NULL;
    }

    if (!$this->handlesEntity($term)) {
      return NULL;
    }

    return $term;
  }

  /**
   * {@inheritdoc}
   */
  public function buildBreadcrumb(Breadcrumb $breadcrumb, EntityInterface $entity): void {
    if (!$entity instanceof TermInterface) {
      return;
    }

    // Add all ancestors in the taxonomy hierarchy.
    $term_storage = $this->entityTypeManager->getStorage('taxonomy_term');
    $ancestors = $term_storage->loadAllParents($entity->id());
    $ancestors = array_reverse($ancestors);

    foreach ($ancestors as $ancestor) {
      $breadcrumb->addCacheableDependency($ancestor);
      $breadcrumb->addLink($ancestor->toLink());
    }
  }

  /**
   * {@inheritdoc}
   */
  public function getSiteSectionId(EntityInterface $entity): int|string|null {
    if (!$entity instanceof TermInterface) {
      return NULL;
    }

    // Only site_section terms can be site sections.
    if ($entity->bundle() !== 'site_section') {
      return NULL;
    }

    return $entity->id();
  }

}