new(ascendNatural, descendNatural) (#127)

package.json

@@ -67,7 +67,7 @@
     "dox": "^1.0.0",
     "eslint": "^8.50.0",
     "eslint-plugin-import": "^2.28.1",
-    "ramda": "^0.30.0",
+    "ramda": "^0.30.1",
     "rimraf": "^5.0.5",
     "tsd": "^0.31.0",
     "typescript": "^5.2.2",

test/ascendNatural.test.ts

@@ -0,0 +1,7 @@
+import { expectType } from 'tsd';
+import { ascendNatural, Ordering, toString } from '../es';
+
+expectType<(a: number, b: number) => Ordering>(ascendNatural('en', toString<number>));
+expectType<(a: string, b: string) => Ordering>(ascendNatural('en', toString<string>));
+expectType<(a: number, b: number) => Ordering>(ascendNatural('en')(toString<number>));
+expectType<(a: string, b: string) => Ordering>(ascendNatural('en')(toString<string>));

test/descendNatural.test.ts

@@ -0,0 +1,7 @@
+import { expectType } from 'tsd';
+import { descendNatural, Ordering, toString } from '../es';
+
+expectType<(a: number, b: number) => Ordering>(descendNatural('en', toString<number>));
+expectType<(a: string, b: string) => Ordering>(descendNatural('en', toString<string>));
+expectType<(a: number, b: number) => Ordering>(descendNatural('en')(toString<number>));
+expectType<(a: string, b: string) => Ordering>(descendNatural('en')(toString<string>));

types/ascendNatural.d.ts

@@ -0,0 +1,5 @@
+import { Ordering } from './util/tools';
+
+export function ascendNatural(locales: string | string[]): <T>(fn: (obj: T) => string) => (a: T, b: T) => Ordering;
+export function ascendNatural<T>(locales: string | string[], fn: (obj: T) => string): (a: T, b: T) => Ordering;
+export function ascendNatural<T>(locales: string | string[], fn: (obj: T) => string, a: T, b: T): Ordering;

types/descendNatural.d.ts

@@ -0,0 +1,5 @@
+import { Ordering } from './util/tools';
+
+export function descendNatural(locales: string | string[]): <T>(fn: (obj: T) => string) => (a: T, b: T) => Ordering;
+export function descendNatural<T>(locales: string | string[], fn: (obj: T) => string): (a: T, b: T) => Ordering;
+export function descendNatural<T>(locales: string | string[], fn: (obj: T) => string, a: T, b: T): Ordering;

types/toString.d.ts

@@ -1 +1 @@
-export function toString(val: unknown): string;
+export function toString<T>(val: T): string;