feat: add Liquid filters 'sample', 'days_ago'

app/Liquid/Filters/Data.php

@@ -63,4 +63,19 @@ class Data extends FiltersProvider
 
         return $grouped;
     }
+
+    /**
+     * Return a random element from an array
+     *
+     * @param  array  $array  The array to sample from
+     * @return mixed A random element from the array
+     */
+    public function sample(array $array): mixed
+    {
+        if (empty($array)) {
+            return null;
+        }
+
+        return $array[array_rand($array)];
+    }
 }

app/Liquid/Filters/Date.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Liquid\Filters;
+
+use Keepsuit\Liquid\Filters\FiltersProvider;
+use Carbon\Carbon;
+
+/**
+ * Data filters for Liquid templates
+ */
+class Date extends FiltersProvider
+{
+    /**
+     * Calculate a date that is a specified number of days in the past
+     *
+     * @param  int|string  $num  The number of days to subtract
+     * @return string The date in Y-m-d format
+     */
+    public function days_ago(int|string $num): string
+    {
+        $days = (int) $num;
+
+        return Carbon::now()->subDays($days)->toDateString();
+    }
+}

app/Models/Plugin.php

@@ -4,6 +4,7 @@ namespace App\Models;
 
 use App\Liquid\FileSystems\InlineTemplatesFileSystem;
 use App\Liquid\Filters\Data;
+use App\Liquid\Filters\Date;
 use App\Liquid\Filters\Localization;
 use App\Liquid\Filters\Numbers;
 use App\Liquid\Filters\StringMarkup;
@@ -215,6 +216,7 @@ class Plugin extends Model
     {
         $replacements = [
             'date: "%N"' => 'date: "u"',
+            'date: "%u"' => 'date: "u"',
             '%-m/%-d/%Y' => 'm/d/Y',
         ];
 
@@ -271,11 +273,12 @@ class Plugin extends Model
                 );
 
                 // Register all custom filters
-                $environment->filterRegistry->register(Numbers::class);
                 $environment->filterRegistry->register(Data::class);
+                $environment->filterRegistry->register(Date::class);
+                $environment->filterRegistry->register(Localization::class);
+                $environment->filterRegistry->register(Numbers::class);
                 $environment->filterRegistry->register(StringMarkup::class);
                 $environment->filterRegistry->register(Uniqueness::class);
-                $environment->filterRegistry->register(Localization::class);
 
                 // Register the template tag for inline templates
                 $environment->tagRegistry->register(TemplateTag::class);

tests/Unit/Liquid/Filters/DataTest.php

@@ -237,3 +237,43 @@ test('group_by filter handles mixed data types as keys', function () {
         '' => [['name' => 'Alice', 'active' => null]], // PHP converts null keys to empty string
     ]);
 });
+
+test('sample filter returns a random element from array', function () {
+    $filter = new Data();
+    $array = ['1', '2', '3', '4', '5'];
+
+    $result = $filter->sample($array);
+    expect($result)->toBeIn($array);
+});
+
+test('sample filter returns a random element from string array', function () {
+    $filter = new Data();
+    $array = ['cat', 'dog'];
+
+    $result = $filter->sample($array);
+    expect($result)->toBeIn($array);
+});
+
+test('sample filter returns null for empty array', function () {
+    $filter = new Data();
+    $array = [];
+
+    $result = $filter->sample($array);
+    expect($result)->toBeNull();
+});
+
+test('sample filter returns the only element from single element array', function () {
+    $filter = new Data();
+    $array = ['single'];
+
+    $result = $filter->sample($array);
+    expect($result)->toBe('single');
+});
+
+test('sample filter works with mixed data types', function () {
+    $filter = new Data();
+    $array = [1, 'string', true, null, ['nested']];
+
+    $result = $filter->sample($array);
+    expect($result)->toBeIn($array);
+});

tests/Unit/Liquid/Filters/DateTest.php

@@ -0,0 +1,32 @@
+<?php
+
+use App\Liquid\Filters\Date;
+use Carbon\Carbon;
+
+test('days_ago filter returns correct date', function () {
+    $filter = new Date();
+    $threeDaysAgo = Carbon::now()->subDays(3)->toDateString();
+
+    expect($filter->days_ago(3))->toBe($threeDaysAgo);
+});
+
+test('days_ago filter handles string input', function () {
+    $filter = new Date();
+    $fiveDaysAgo = Carbon::now()->subDays(5)->toDateString();
+
+    expect($filter->days_ago('5'))->toBe($fiveDaysAgo);
+});
+
+test('days_ago filter with zero days returns today', function () {
+    $filter = new Date();
+    $today = Carbon::now()->toDateString();
+
+    expect($filter->days_ago(0))->toBe($today);
+});
+
+test('days_ago filter with large number works correctly', function () {
+    $filter = new Date();
+    $hundredDaysAgo = Carbon::now()->subDays(100)->toDateString();
+
+    expect($filter->days_ago(100))->toBe($hundredDaysAgo);
+});