@reldens/utils 0.55.0 → 0.57.0

package/CLAUDE.md

@@ -1,7 +1,3 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
 ## Package Overview
 
 **@reldens/utils** is a core utility package used throughout the Reldens ecosystem. It provides essential utilities for:

package/lib/shortcuts.js

@@ -404,6 +404,19 @@ class Shortcuts
         return array[Math.floor(Math.random() * array.length)];
     }
 
+    shuffleArray(array)
+    {
+        if(!this.isArray(array)){
+            return [];
+        }
+        let newArray = [...array];
+        for(let i = newArray.length - 1; i > 0; i--){
+            let swapIndex = Math.floor(Math.random() * (i + 1));
+            [newArray[i], newArray[swapIndex]] = [newArray[swapIndex], newArray[i]];
+        }
+        return newArray;
+    }
+
     randomInteger(min, max)
     {
         return Math.floor(Math.random() * (max - min + 1)) + min;

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@reldens/utils",
     "scope": "@reldens",
-    "version": "0.55.0",
+    "version": "0.57.0",
     "description": "Reldens - Utils",
     "author": "Damian A. Pastorini",
     "license": "MIT",

package/tests/shortcuts-test.js

@@ -673,6 +673,24 @@ class TestShortcuts
         });
     }
 
+    testShuffleArray()
+    {
+        this.test('returns an array with the same elements', () => {
+            let values = [1, 2, 3, 4, 5];
+            let result = sc.shuffleArray(values);
+            this.assert(5 === result.length);
+            this.assert(values.every(value => sc.inArray(value, result)));
+        });
+        this.test('does not mutate the input array', () => {
+            let values = [1, 2, 3];
+            sc.shuffleArray(values);
+            this.assert(3 === values.length && 1 === values[0] && 2 === values[1] && 3 === values[2]);
+        });
+        this.test('returns empty array for non-array', () => {
+            this.assert(0 === sc.shuffleArray(null).length);
+        });
+    }
+
     testRandomInteger()
     {
         this.test('returns integer within range', () => {