feat: implement and test new sort function

src/index.js

@@ -15,3 +15,13 @@ export function sum(values) {
 export function average(values) {
   return sum(values) / values.length;
 }
+
+/**
+ * Sort array by numeric values.
+ * @param {number[]} values Numbers to sort.
+ * @param {'asc' | 'desc'} order Ascending (default) or descending order.
+ * @returns {number[]} Sorted array.
+ */
+export function sort(values, order = 'asc') {
+  return [...values].sort((a, b) => (order === 'desc' ? b - a : a - b));
+}

test/index.test.js

@@ -1,6 +1,6 @@
 import assert from 'node:assert';
 import { describe, it } from 'node:test';
-import { average, sum } from '../src/index.js';
+import { average, sort, sum } from '../src/index.js';
 
 describe('sum', () => {
   it('should sum all numbers', () => {
@@ -17,3 +17,13 @@ describe('average', () => {
     assert.strictEqual(average([1, 2, 3, 4]), 2.5);
   });
 });
+
+describe('sort', () => {
+  it('should sort numbers in ascending order by default', () => {
+    assert.deepEqual(sort([4, 2, 1, 3]), [1, 2, 3, 4]);
+  });
+
+  it('should sort numbers in descending order if specified', () => {
+    assert.deepEqual(sort([4, 2, 1, 3], 'desc'), [4, 3, 2, 1]);
+  });
+});