feat: Add PrimeProgress, PrimeSelect, and PrimeSkeleton components with customizable styles and props

- Implemented PrimeProgress component with support for labels, helper text, and various styles (size, variant, color).
- Created PrimeSelect component with dropdown functionality, custom templates, and validation states.
- Developed PrimeSkeleton component for loading placeholders with different shapes and animations.
- Updated index.ts to export new components for easy import.
- Enhanced PrimeVueTest.vue to include tests for new components and their functionalities.
- Introduced a custom ThrillWiki theme for PrimeVue with tailored color schemes and component styles.
- Added ambient type declarations for various components to improve TypeScript support.

backend/apps/api/v1/rides/serializers.py

@@ -1,18 +1,157 @@
 """
-Serializers for the rides API.
+Ride media serializers for ThrillWiki API v1.
+
+This module contains serializers for ride-specific media functionality.
 """
 
 from rest_framework import serializers
-
 from apps.rides.models import Ride, RidePhoto
 
 
-class RidePhotoSerializer(serializers.ModelSerializer):
-    """Serializer for the RidePhoto model."""
+class RidePhotoOutputSerializer(serializers.ModelSerializer):
+    """Output serializer for ride photos."""
+
+    uploaded_by_username = serializers.CharField(
+        source="uploaded_by.username", read_only=True
+    )
+    file_size = serializers.ReadOnlyField()
+    dimensions = serializers.ReadOnlyField()
+    ride_slug = serializers.CharField(source="ride.slug", read_only=True)
+    ride_name = serializers.CharField(source="ride.name", read_only=True)
+    park_slug = serializers.CharField(source="ride.park.slug", read_only=True)
+    park_name = serializers.CharField(source="ride.park.name", read_only=True)
 
     class Meta:
         model = RidePhoto
-        fields = (
+        fields = [
+            "id",
+            "image",
+            "caption",
+            "alt_text",
+            "is_primary",
+            "is_approved",
+            "photo_type",
+            "created_at",
+            "updated_at",
+            "date_taken",
+            "uploaded_by_username",
+            "file_size",
+            "dimensions",
+            "ride_slug",
+            "ride_name",
+            "park_slug",
+            "park_name",
+        ]
+        read_only_fields = [
+            "id",
+            "created_at",
+            "updated_at",
+            "uploaded_by_username",
+            "file_size",
+            "dimensions",
+            "ride_slug",
+            "ride_name",
+            "park_slug",
+            "park_name",
+        ]
+
+
+class RidePhotoCreateInputSerializer(serializers.ModelSerializer):
+    """Input serializer for creating ride photos."""
+
+    class Meta:
+        model = RidePhoto
+        fields = [
+            "image",
+            "caption",
+            "alt_text",
+            "photo_type",
+            "is_primary",
+        ]
+
+
+class RidePhotoUpdateInputSerializer(serializers.ModelSerializer):
+    """Input serializer for updating ride photos."""
+
+    class Meta:
+        model = RidePhoto
+        fields = [
+            "caption",
+            "alt_text",
+            "photo_type",
+            "is_primary",
+        ]
+
+
+class RidePhotoListOutputSerializer(serializers.ModelSerializer):
+    """Simplified output serializer for ride photo lists."""
+
+    uploaded_by_username = serializers.CharField(
+        source="uploaded_by.username", read_only=True
+    )
+
+    class Meta:
+        model = RidePhoto
+        fields = [
+            "id",
+            "image",
+            "caption",
+            "photo_type",
+            "is_primary",
+            "is_approved",
+            "created_at",
+            "uploaded_by_username",
+        ]
+        read_only_fields = fields
+
+
+class RidePhotoApprovalInputSerializer(serializers.Serializer):
+    """Input serializer for photo approval operations."""
+
+    photo_ids = serializers.ListField(
+        child=serializers.IntegerField(), help_text="List of photo IDs to approve"
+    )
+    approve = serializers.BooleanField(
+        default=True, help_text="Whether to approve (True) or reject (False) the photos"
+    )
+
+
+class RidePhotoStatsOutputSerializer(serializers.Serializer):
+    """Output serializer for ride photo statistics."""
+
+    total_photos = serializers.IntegerField()
+    approved_photos = serializers.IntegerField()
+    pending_photos = serializers.IntegerField()
+    has_primary = serializers.BooleanField()
+    recent_uploads = serializers.IntegerField()
+    by_type = serializers.DictField(
+        child=serializers.IntegerField(), help_text="Photo counts by type"
+    )
+
+
+class RidePhotoTypeFilterSerializer(serializers.Serializer):
+    """Serializer for filtering photos by type."""
+
+    photo_type = serializers.ChoiceField(
+        choices=[
+            ("exterior", "Exterior View"),
+            ("queue", "Queue Area"),
+            ("station", "Station"),
+            ("onride", "On-Ride"),
+            ("construction", "Construction"),
+            ("other", "Other"),
+        ],
+        required=False,
+        help_text="Filter photos by type",
+    )
+
+
+class RidePhotoSerializer(serializers.ModelSerializer):
+    """Legacy serializer for backward compatibility."""
+
+    class Meta:
+        model = RidePhoto
+        fields = [
             "id",
             "image",
             "caption",
@@ -21,7 +160,7 @@ class RidePhotoSerializer(serializers.ModelSerializer):
             "photo_type",
             "uploaded_at",
             "uploaded_by",
-        )
+        ]
 
 
 class RideSerializer(serializers.ModelSerializer):
@@ -29,7 +168,7 @@ class RideSerializer(serializers.ModelSerializer):
 
     class Meta:
         model = Ride
-        fields = (
+        fields = [
             "id",
             "name",
             "slug",
@@ -40,4 +179,4 @@ class RideSerializer(serializers.ModelSerializer):
             "status",
             "opening_date",
             "closing_date",
-        )
+        ]