feat: enhance item attributes management by adding sort order; update related models, resources, and tests for visibility and ordering of variants

app/Domains/Catalog/Models/Variant.php

@@ -152,7 +152,7 @@ class Variant extends Model
     /**
      * @return Collection<string, array{value: string, label: string}|array<int, array{value: string, label: string}>>
      */
-    public function selectionOptions(): Collection
+    public function selectionOptions(?Collection $itemAttributes = null): Collection
     {
         $options = $this->definitions
             ->groupBy('item_attribute_id')
@@ -197,7 +197,37 @@ class Variant extends Model
             $options->put('event_date', $eventDateOptions->all());
         }
 
-        return $options;
+        if ($itemAttributes === null) {
+            $itemAttributes = $this->definitions
+                ->map(fn (VariantDefinition $definition) => $definition->itemAttribute)
+                ->filter()
+                ->unique('id')
+                ->values();
+
+            if ($this->catalogItem !== null) {
+                $itemAttributes = $itemAttributes
+                    ->merge($this->catalogItem->itemAttributes)
+                    ->unique('id')
+                    ->values();
+            }
+        }
+
+        $ordering = $itemAttributes->mapWithKeys(function (ItemAttribute $itemAttribute): array {
+            $attribute = $itemAttribute->attribute;
+
+            return $attribute === null
+                ? []
+                : [$attribute->codigo => [$itemAttribute->sort_order, mb_strtolower($attribute->nombre)]];
+        });
+
+        return $options->sortKeysUsing(function (string $left, string $right) use ($ordering): int {
+            [$leftOrder, $leftLabel] = $ordering->get($left, [0, mb_strtolower($left)]);
+            [$rightOrder, $rightLabel] = $ordering->get($right, [0, mb_strtolower($right)]);
+
+            return $leftOrder <=> $rightOrder
+                ?: $leftLabel <=> $rightLabel
+                ?: $left <=> $right;
+        });
     }
 
     /** @return Collection<int, EventDate> */