<?php
/**
 * Livewire Component
 *
 * @version     1.0.$Revision:$
 * @version     SVN: $Id:$
 * @package     bplan-base/globals
 * @subpackage  LivewireComponents
 * @author      Emilio Cannarozzo <emilio.cannarozzo@bplan-solutions.de>
 * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
 * @copyright   Copyright (C) 2025, 2026 bplan-solutions GmbH & Co. KG <https://www.bplan-solutions.de/>
 * /Δ\
 */

namespace BplanBase\Globals\Traits;


/**
 * Livewire Component
 *
 * Spalten für die Sortierung müssen in den Locale-Dateien der Component unter
 * "grid-locales.sort-fields' definiert werden.
 * Beispiel:
 *
 *      return [
 *          ...
 *          'grid-locales' => [
 *              ...
 *              'sort-fields' => [
 *                  'email'        => 'E-Mail',
 *                  'labels->%lc%' => 'Label',
 *                  'name'         => 'Name',
 *              ],
 *          ],
 *      ];
 *
 * Alle dort verzeichneten Felder werden automatisch, in der Reihenfolge in der
 * sie in der Locale-Datei angegeben sind, in die Auswahl aufgenommen.
 *
 * Die Notation "labels->%lc%" gilt für Json-Felder, in denen mehrsprachige Werte
 * mit Ländercodes als Schlüssel gespeichert sind:
 *      {"de": "Allgemein", "en": "General"}
 *
 * Der Platzhalter "%lc%" wird zur Laufzeit durch den Ländercode der aktuell
 * eingestellten Sprache ersetzt.
 *
 * @todo        Die Sortierung könnte optional in der Session abgelegt werden, um sie
 *              dauerhaft zu machen.
 *
 * @version     2.0.0 / 2026-04-09
 * @author      Emilio Cannarozzo <emilio.cannarozzo@bplan-solutions.de>
 * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
 */
trait WithSorting
{


/* +++ TRAITS +++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ */


/* +++ CLASS CONSTANTS +++ ++++++++++++++++++++++++++++++++++++++++++++++++++ */


/* +++ OBJECT MEMBERS +++ +++++++++++++++++++++++++++++++++++++++++++++++++++ */


    /**
     * @var     null|string
     */
    public null|string $sortColumn = null;


    /**
     * @var     array
     */
    public array $sortColumns = [];


    /**
     * @var     string
     */
    public string $sortDirection = 'asc';


/* +++ CLASS MEMBERS +++ ++++++++++++++++++++++++++++++++++++++++++++++++++++ */


/* +++ OBJECT METHODS +++ +++++++++++++++++++++++++++++++++++++++++++++++++++ */


    /**
     *
     * @version     1.0.0 / 2026-04-09
     * @author      Emilio Cannarozzo <emilio.cannarozzo@bplan-solutions.de>
     * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
     */
    protected function _getOrderBy(): array|null
    {
        $orderBy = null;

        if (!empty($this->sortColumn)) {
            $orderBy = [
                [
                    'column'    => str_replace('%lc%', app()->getLocale(), $this->sortColumn),
                    'direction' => $this->sortDirection,
                ],
            ];
        }
        return $orderBy;

    } // _getOrderBy()


    /**
     * Fügt automatisch den Listener für sortingChanged hinzu
     *
     * Bestehende Listener in der Klasse werden nicht überschrieben.
     *
     * @version     1.0.0 / 2025-09-20
     * @author      Emilio Cannarozzo <emilio.cannarozzo@bplan-solutions.de>
     * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
     */
    public function getListeners()
    {
        /*
        **  Listener des Parents abrufen und ergänzen. */
        $parentListeners = property_exists($this, 'listeners') ? $this->listeners : [];

        $traitListener = [
            'sortingChanged' => 'updateSorting',
        ];
        return array_merge($parentListeners, $traitListener);

    } // getListeners()


    /**
     *
     * @return      void
     *
     * @version     1.0.0 / 2026-04-06
     * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
     */
    public function mountWithSorting(): void
    {
        $sortColumns = __($this->_gridLocaleFile.'.grid-locales.sort-fields');

        $this->sortColumns = is_array($sortColumns) ?  $sortColumns : [];

    } // mountWithSorting()


    /**
     * Standard-Methode, die von SortSelect aufgerufen wird
     *
     * @param       string $column
     *
     * @param       string $direction
     *
     * @return      void
     *
     * @version     2.1.0 / 2026-04-09
     * @author      Emilio Cannarozzo <emilio.cannarozzo@bplan-solutions.de>
     * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
     */
    public function updateSorting(null|string $column, null|string $direction): void
    {
        if ($column === '') {
            $this->sortColumn = null;

        } elseif (!array_key_exists($column, $this->sortColumns)) {
            return;
        }
        $this->sortColumn    = $column;
        $this->sortDirection = $direction;

    } // updateSorting()


/* +++ CLASS METHODS +++ ++++++++++++++++++++++++++++++++++++++++++++++++++++ */


} // trait WithSorting {}
