LessThan, LessThanOrEqual, GreaterThanOrEqual: Add function parameter constraint examples

Author: derodero24

source/greater-than-or-equal.d.ts

@@ -16,6 +16,20 @@ type B = GreaterThanOrEqual<1, 1>;
 type C = GreaterThanOrEqual<1, 5>;
 //=> false
 ```
+
+@example
+```
+import type {GreaterThanOrEqual} from 'type-fest';
+
+// Use `GreaterThanOrEqual` to constrain a function parameter to non-negative numbers.
+declare function setNonNegative<N extends number>(value: GreaterThanOrEqual<N, 0> extends true ? N : never): void;
+
+setNonNegative(0);
+setNonNegative(1);
+
+// @ts-expect-error
+setNonNegative(-1);
+```
 */
 export type GreaterThanOrEqual<A extends number, B extends number> = number extends A | B
 	? never

source/less-than-or-equal.d.ts

@@ -16,6 +16,20 @@ type B = LessThanOrEqual<1, 1>;
 type C = LessThanOrEqual<1, 5>;
 //=> true
 ```
+
+@example
+```
+import type {LessThanOrEqual} from 'type-fest';
+
+// Use `LessThanOrEqual` to constrain a function parameter to non-positive numbers.
+declare function setNonPositive<N extends number>(value: LessThanOrEqual<N, 0> extends true ? N : never): void;
+
+setNonPositive(-1);
+setNonPositive(0);
+
+// @ts-expect-error
+setNonPositive(1);
+```
 */
 export type LessThanOrEqual<A extends number, B extends number> = number extends A | B
 	? never

source/less-than.d.ts

@@ -16,6 +16,22 @@ type B = LessThan<1, 1>;
 type C = LessThan<1, 5>;
 //=> true
 ```
+
+@example
+```
+import type {LessThan} from 'type-fest';
+
+// Use `LessThan` to constrain a function parameter to negative numbers.
+declare function setNegative<N extends number>(value: LessThan<N, 0> extends true ? N : never): void;
+
+setNegative(-1);
+
+// @ts-expect-error
+setNegative(0);
+
+// @ts-expect-error
+setNegative(1);
+```
 */
 export type LessThan<A extends number, B extends number> = number extends A | B
 	? never