feat: add asc and desc func

.changeset/ninety-suits-hug.md

@@ -0,0 +1,5 @@
+---
+"sortman": minor
+---
+
+feat: add ascending and descending sort utility functions

.changeset/seven-roses-allow.md

@@ -0,0 +1,5 @@
+---
+"sortman": minor
+---
+
+fix: export swap utility from utils

README.md

@@ -16,6 +16,18 @@ Please import `sortman` or `sortman/tiny`.
 
 **`sortman/tiny` was minified by terser**
 
+```ts
+import { asc } from "sortman";
+
+const data = [200, 300, 100];
+
+const sorted = data.sort(asc);
+
+console.log(sorted);
+```
+
+# Usage (not default sort)
+
 ```ts
 import { SortMan } from "sortman";
 

src/index.ts

@@ -35,3 +35,6 @@ export class SortMan {
 		}
 	}
 }
+
+export * from "./utils/sort";
+export * from "./utils/swap";

src/utils/sort.ts

@@ -0,0 +1,7 @@
+export function asc(a: number, b: number): number {
+	return a - b;
+}
+
+export function desc(a: number, b: number): number {
+	return b - a;
+}

tests/sort.test.ts

@@ -1,6 +1,7 @@
 import { describe, expect, test } from "@jest/globals";
 import { ignoreSorts, numArrData, objectArrData, sorts } from "./utils";
 import { sortCheck } from "../src/utils/array";
+import { asc, desc } from "../src";
 
 function evalTest(originalData: number[], sortedData: number[], desc?: boolean): boolean {
 	const isSameArr = (() => {
@@ -66,3 +67,25 @@ for (const { name, algorithm, options } of sorts) {
 		});
 	}
 }
+
+describe("Sort functions tests", () => {
+	test("asc", () => {
+		expect(evalTest(numArrData, numArrData.sort(asc))).toBe(true);
+		expect(
+			evalTest(
+				objectArrData.map(({ num }) => num),
+				objectArrData.sort((a, b) => asc(a.num, b.num)).map(({ num }) => num)
+			)
+		).toBe(true);
+	});
+	test("desc", () => {
+		expect(evalTest(numArrData, numArrData.sort(desc), true)).toBe(true);
+		expect(
+			evalTest(
+				objectArrData.map(({ num }) => num),
+				objectArrData.sort((a, b) => desc(a.num, b.num)).map(({ num }) => num),
+				true
+			)
+		).toBe(true);
+	});
+});