Replace OverrideOrderFieldsColumnInterface to SortableColumnInterface

src/BaseListView.php

@@ -170,7 +170,7 @@
 
     final public function ignoreMissingPage(bool $value): static
     {
         $new = clone $this;
         $new->ignoreMissingPage = $value;
         return $new;
     }
@@ -218,7 +218,7 @@
 
     final public function urlParameterProvider(?UrlParameterProviderInterface $provider): static
     {
         $new = clone $this;
         $new->urlParameterProvider = $provider;
         return $new;
     }
@@ -313,7 +313,7 @@
      *
      * @psalm-return list{FilterInterface[]|null,ValidationResult}
      */
     protected function makeFilters(): array
     {
         return [[], new ValidationResult()];
     }
@@ -424,19 +424,22 @@
             }
         }
 
         if (!empty($sort) && $dataReader->isSortable()) {
             $sortObject = $dataReader->getSort();
             if ($sortObject !== null) {
                 $order = OrderHelper::stringToArray($sort);
                 if (!$this->enableMultiSort) {
                     $order = array_slice($order, 0, 1, true);
                 }
-                $this->prepareOrder($order);
-                $dataReader = $dataReader->withSort($sortObject->withOrder($order));
+                $dataReader = $dataReader->withSort(
+                    $sortObject->withOrder(
+                        $this->prepareOrder($order)
+                    )
+                );
             }
         }
 
         if (!empty($filters) && $dataReader->isFilterable()) {
             $dataReader = $dataReader->withFilter(new All(...$filters));
         }
 
@@ -445,9 +448,11 @@
 
     /**
      * @psalm-param TOrder $order
+     * @psalm-return TOrder
      */
-    protected function prepareOrder(array &$order): void
+    protected function prepareOrder(array $order): array
     {
+        return [];
     }
 
     /**
@@ -571,7 +576,7 @@
      */
     public function offsetPaginationConfig(array $config): static
     {
         $new = clone $this;
         $new->offsetPaginationConfig = $config;
         return $new;
     }
@@ -584,7 +589,7 @@
      */
     public function keysetPaginationConfig(array $config): static
     {
         $new = clone $this;
         $new->keysetPaginationConfig = $config;
         return $new;
     }
@@ -777,7 +782,7 @@
      *
      * @psalm-return array<string, string>
      */
-    protected function getOverrideOrderFields(): array
+    protected function getOrderProperties(): array
     {
         return [];
     }
@@ -838,7 +843,6 @@
         }
 
         $context = new PaginationContext(
-            $this->getOverrideOrderFields(),
             $nextUrlPattern,
             $previousUrlPattern,
             $defaultUrl,
@@ -931,7 +935,7 @@
         $currentPage = $dataReader->getCurrentPage();
 
         // The starting row number (1-based) currently being displayed
         $begin = ($currentPage - 1) * $dataReader->getPageSize() + 1;
 
         // The number of rows currently being displayed
         $count = $dataReader->getCurrentPageSize();
@@ -1046,7 +1050,7 @@
         }
 
         $order = [];
-        $overrideOrderFields = array_flip($this->getOverrideOrderFields());
+        $overrideOrderFields = array_flip($this->getOrderProperties());
         foreach ($sort->getOrder() as $name => $value) {
             $key = array_key_exists($name, $overrideOrderFields)
                 ? $overrideOrderFields[$name]

src/Column/Base/HeaderContext.php

@@ -27,13 +27,13 @@ final class HeaderContext
     /**
      * @internal
      *
-     * @psalm-param array<string, string> $overrideOrderFields
+     * @psalm-param array<string, string> $orderProperties
      * @psalm-param UrlCreator|null $urlCreator
      */
     public function __construct(
         private readonly ?Sort $originalSort,
         private readonly ?Sort $sort,
-        private readonly array $overrideOrderFields,
+        private readonly array $orderProperties,
         private readonly ?string $sortableHeaderClass,
         private readonly string|Stringable $sortableHeaderPrepend,
         private readonly string|Stringable $sortableHeaderAppend,
@@ -67,8 +67,13 @@ public function translate(string|Stringable $id): string
     public function prepareSortable(Cell $cell, string $property): array
     {
         $originalProperty = $property;
-        $property = $this->overrideOrderFields[$property] ?? $property;
-        if ($this->sort === null || $this->originalSort === null || !$this->sort->hasFieldInConfig($property)) {
+        $property = $this->orderProperties[$property] ?? '';
+        if (
+            $property === ''
+            || $this->sort === null
+            || $this->originalSort === null
+            || !$this->sort->hasFieldInConfig($property)
+        ) {
             return [$cell, null, '', ''];
         }
 

src/Column/DataColumnRenderer.php

@@ -33,7 +33,7 @@
 /**
  * @psalm-import-type FilterEmptyCallable from DataColumn
  */
-final class DataColumnRenderer implements FilterableColumnRendererInterface, OverrideOrderFieldsColumnInterface
+final class DataColumnRenderer implements FilterableColumnRendererInterface, SortableColumnInterface
 {
     /**
      * @var bool|callable
@@ -271,18 +271,15 @@ private function checkColumn(ColumnInterface $column): void
         }
     }
 
-    public function getOverrideOrderFields(ColumnInterface $column): array
+    public function getOrderProperties(ColumnInterface $column): array
     {
         $this->checkColumn($column);
         /** @var DataColumn $column This annotation is for IDE only */
 
-        if ($column->property === null
-            || $column->field === null
-            || $column->property === $column->field
-        ) {
+        if ($column->property === null) {
             return [];
         }
 
-        return [$column->property => $column->field];
+        return [$column->property => $column->field ?? $column->property];
     }
 }

src/Column/SortableColumnInterface.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Yiisoft\Yii\DataView\Column;
+
+interface SortableColumnInterface
+{
+    /**
+     * @return array The properties that can be sorted by this column. The array keys are the logical property names,
+     * and the array values are the corresponding field names.
+     *
+     * @psalm-return array<string,string>
+     */
+    public function getOrderProperties(ColumnInterface $column): array;
+}

src/GridView.php

@@ -7,7 +7,6 @@
 use Closure;
 use Psr\Container\ContainerInterface;
 use Stringable;
-use Yiisoft\Arrays\ArrayHelper;
 use Yiisoft\Data\Paginator\PaginatorInterface;
 use Yiisoft\Data\Reader\ReadableDataInterface;
 use Yiisoft\Data\Reader\Sort;
@@ -26,9 +25,10 @@
 use Yiisoft\Yii\DataView\Column\ColumnInterface;
 use Yiisoft\Yii\DataView\Column\ColumnRendererInterface;
 use Yiisoft\Yii\DataView\Column\FilterableColumnRendererInterface;
-use Yiisoft\Yii\DataView\Column\OverrideOrderFieldsColumnInterface;
+use Yiisoft\Yii\DataView\Column\SortableColumnInterface;
 use Yiisoft\Yii\DataView\Filter\Factory\IncorrectValueException;
 
+use function array_key_exists;
 use function call_user_func;
 use function call_user_func_array;
 use function is_callable;
@@ -565,7 +565,7 @@ protected function renderItems(array $items, ValidationResult $filterValidationR
             $headerContext = new HeaderContext(
                 $this->getSort($dataReader),
                 $this->getSort($this->preparedDataReader),
-                $this->getOverrideOrderFields(),
+                $this->getOrderProperties(),
                 $this->sortableHeaderClass,
                 $this->sortableHeaderPrepend,
                 $this->sortableHeaderAppend,
@@ -700,32 +700,38 @@ protected function makeFilters(): array
         return [$filters, $validationResult];
     }
 
-    protected function prepareOrder(array &$order): void
+    protected function prepareOrder(array $order): array
     {
         $columns = $this->getColumns();
         $renderers = $this->getColumnRenderers();
+
+        $result = [];
         foreach ($columns as $i => $column) {
-            if ($renderers[$i] instanceof OverrideOrderFieldsColumnInterface) {
-                foreach ($renderers[$i]->getOverrideOrderFields($column) as $from => $to) {
-                    $order = ArrayHelper::renameKey($order, $from, $to);
+            if ($renderers[$i] instanceof SortableColumnInterface) {
+                foreach ($renderers[$i]->getOrderProperties($column) as $from => $to) {
+                    if (array_key_exists($from, $order)) {
+                        $result[$to] = $order[$from];
+                    }
                 }
             }
         }
+
+        return $result;
     }
 
-    protected function getOverrideOrderFields(): array
+    protected function getOrderProperties(): array
     {
         $columns = $this->getColumns();
         $renderers = $this->getColumnRenderers();
 
-        $overrideOrderFields = [];
+        $orderProperties = [];
         foreach ($columns as $i => $column) {
-            if ($renderers[$i] instanceof OverrideOrderFieldsColumnInterface) {
-                $overrideOrderFields[] = $renderers[$i]->getOverrideOrderFields($column);
+            if ($renderers[$i] instanceof SortableColumnInterface) {
+                $orderProperties[] = $renderers[$i]->getOrderProperties($column);
             }
         }
 
-        return array_merge(...$overrideOrderFields);
+        return array_merge(...$orderProperties);
     }
 
     /**

src/Pagination/PaginationContext.php

@@ -12,11 +12,8 @@ final class PaginationContext
 
     /**
      * @internal
-     *
-     * @param array<string, string> $overrideOrderFields
      */
     public function __construct(
-        public readonly array $overrideOrderFields,
         public readonly string $nextUrlPattern,
         public readonly string $previousUrlPattern,
         public readonly string $defaultUrl,