@bytebury/toolkit 1.0.0 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-<img src="./assets/logo.png" alt="Toolkit Logo" width="256" height="256" /><br />
+<img src="./assets/logo.png" alt="Toolkit Logo" width="348" height="256" /><br />
 
 # toolkit
 

package/esm/_dnt.shims.d.ts

@@ -0,0 +1,10 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+import { setInterval, setTimeout } from "@deno/shim-timers";
+export { setInterval, setTimeout } from "@deno/shim-timers";
+export declare const dntGlobalThis: Omit<typeof globalThis, "setInterval" | "setTimeout" | "Deno"> & {
+    Deno: typeof Deno;
+    setInterval: typeof setInterval;
+    setTimeout: typeof setTimeout;
+};
+//# sourceMappingURL=_dnt.shims.d.ts.map

package/esm/_dnt.shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.shims.d.ts","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAO5D,eAAO,MAAM,aAAa;;;;CAA2C,CAAC"}

package/esm/_dnt.shims.js

@@ -0,0 +1,65 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+import { setInterval, setTimeout } from "@deno/shim-timers";
+export { setInterval, setTimeout } from "@deno/shim-timers";
+const dntGlobals = {
+    Deno,
+    setInterval,
+    setTimeout,
+};
+export const dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

package/esm/_dnt.test_shims.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_dnt.test_shims.d.ts","sourceRoot":"","sources":["../src/_dnt.test_shims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAKvC,eAAO,MAAM,aAAa;;CAA2C,CAAC"}
+{"version":3,"file":"_dnt.test_shims.d.ts","sourceRoot":"","sources":["../src/_dnt.test_shims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAO5D,eAAO,MAAM,aAAa;;;;CAA2C,CAAC"}

package/esm/src/core.d.ts

@@ -221,7 +221,7 @@ export declare function sample<T>(list: NonEmptyList<T>): T;
  * rand(3, 7); // 3 -> 6
  * ```
  */
-export declare function rand(start: number, end: number): number;
+export declare function random(start: number, end: number): number;
 /**
  * Determines if the given value is truthy.
  *
@@ -269,29 +269,33 @@ export declare function isSome(thing: unknown): boolean;
  */
 export declare function isNone(thing: unknown): boolean;
 /**
- * Sums the elements in the given list. If you pass a list of numbers, it sums
- * them directly. If you pass a list of objects, provide the key to sum.
+ * Returns a function that does nothing.
  *
  * @example
  * ```ts
- * sum([1, 2, 3]); // 6
- * sum([{ x: 1 }, { x: 2 }], "x"); // 3
+ * const doNothing = noop();
+ * doNothing(); // does nothing
  * ```
  */
-export declare function sum(list: number[]): number;
-export declare function sum<T extends Record<PropertyKey, number>>(list: T[], key: keyof T): number;
+export declare function noop(): void;
 /**
- * Calculates the average of the elements in the given list.
- * If you pass a list of numbers, it calculates the average directly.
- * If you pass a list of objects, provide the key to calculate the average.
+ * Returns true if the given value is within the given range.
  *
  * @example
  * ```ts
- * average([1, 2, 3]); // 2
- * average([{ x: 1 }, { x: 2 }], "x"); // 1.5
- * average([]); // 0
+ * inRange(5, 0, 10); // true
+ * inRange(0, 0, 10); // true
+ * inRange(10, 0, 10); // true
+ * inRange(11, 0, 10); // false
  * ```
  */
-export declare function average(list: number[]): number;
-export declare function average<T extends Record<PropertyKey, number>>(list: T[], key: keyof T): number;
+export declare function inRange(value: number, min: number, max: number): boolean;
+/**
+ * Splits an array into chunks of a fixed size.
+ *
+ * @example
+ * chunk([1,2,3,4,5,6,7], 3); // [[1,2,3],[4,5,6],[7]]
+ * chunk(['a','b','c','d'], 2); // [['a','b'], ['c','d']]
+ */
+export declare function chunk<T>(arr: T[], size: number): T[][];
 //# sourceMappingURL=core.d.ts.map

package/esm/src/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/src/core.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/src/core.ts"],"names":[],"mappings":"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"}

package/esm/src/core.js

@@ -169,7 +169,7 @@ export function distinct(list) {
  * ```
  */
 export function sample(list) {
-    return list[Math.floor(Math.random() * list.length)];
+    return list[random(0, list.length)];
 }
 /**
  * Gives a random number in the given range. The first parameter is inclusive
@@ -182,7 +182,7 @@ export function sample(list) {
  * rand(3, 7); // 3 -> 6
  * ```
  */
-export function rand(start, end) {
+export function random(start, end) {
     return Math.floor(Math.random() * (end - start)) + start;
 }
 /**
@@ -239,18 +239,45 @@ export function isSome(thing) {
 export function isNone(thing) {
     return thing === null || thing === undefined;
 }
-// deno-lint-ignore no-explicit-any
-export function sum(list, key) {
-    if (list.length === 0)
-        return 0;
-    if (typeof list[0] === "number") {
-        return list.reduce((a, v) => a + v, 0);
-    }
-    return list.reduce(
-    // deno-lint-ignore no-explicit-any
-    (a, v) => a + v[key], 0);
+/**
+ * Returns a function that does nothing.
+ *
+ * @example
+ * ```ts
+ * const doNothing = noop();
+ * doNothing(); // does nothing
+ * ```
+ */
+export function noop() {
+    // Do nothing
 }
-// deno-lint-ignore no-explicit-any
-export function average(list, key) {
-    return (sum(list, key) / list.length) || 0;
+/**
+ * Returns true if the given value is within the given range.
+ *
+ * @example
+ * ```ts
+ * inRange(5, 0, 10); // true
+ * inRange(0, 0, 10); // true
+ * inRange(10, 0, 10); // true
+ * inRange(11, 0, 10); // false
+ * ```
+ */
+export function inRange(value, min, max) {
+    return value >= min && value <= max;
+}
+/**
+ * Splits an array into chunks of a fixed size.
+ *
+ * @example
+ * chunk([1,2,3,4,5,6,7], 3); // [[1,2,3],[4,5,6],[7]]
+ * chunk(['a','b','c','d'], 2); // [['a','b'], ['c','d']]
+ */
+export function chunk(arr, size) {
+    if (size <= 0)
+        throw new Error("chunk size must be > 0");
+    const result = [];
+    for (let i = 0; i < arr.length; i += size) {
+        result.push(arr.slice(i, i + size));
+    }
+    return result;
 }

package/esm/src/duration.d.ts

@@ -23,6 +23,19 @@ export type Days = Brand<number, "days">;
 export type Weeks = Brand<number, "weeks">;
 /** Represents a duration of time in years. */
 export type Years = Brand<number, "years">;
+/**
+ * Sleeps for the given duration of milliseconds.
+ *
+ * @example Using `sleep` directly (for milliseconds).
+ * ```ts
+ * await sleep(1_000 as Milliseconds);
+ * ```
+ * @example Using `Duration.sleep` (for non-milliseconds).
+ * ```ts
+ * await Duration.seconds(1 as Seconds).sleep();
+ * ```
+ */
+export declare const sleep: (ms: Milliseconds) => Promise<void>;
 /**
  * A representation of a duration of time within a codebase.
  * This class provides a way to work with durations of time in a type-safe manner.
@@ -98,5 +111,15 @@ export declare class Duration {
      * Converts the duration to years.
      */
     toYears(): Years;
+    /**
+     * Sleeps for the current duration.
+     *
+     * @example
+     * ```ts
+     * const duration = Duration.seconds(5);
+     * await duration.sleep();
+     * ```
+     */
+    sleep(): Promise<void>;
 }
 //# sourceMappingURL=duration.d.ts.map

package/esm/src/duration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../src/src/duration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACzD,gDAAgD;AAChD,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC/C,gDAAgD;AAChD,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC/C,8CAA8C;AAC9C,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,6CAA6C;AAC7C,MAAM,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,8CAA8C;AAC9C,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,8CAA8C;AAC9C,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAQ;IACC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAAjD,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,QAAQ;IAIzD;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ;IAI1C;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ;IAI1C;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ;IAIpC;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ;IAIjC;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ;IAIpC;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ;IAIpC;;OAEG;IACH,cAAc,IAAI,YAAY;IAI9B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,OAAO,IAAI,KAAK;IAIhB;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,OAAO,IAAI,KAAK;IAIhB;;OAEG;IACH,OAAO,IAAI,KAAK;CAGjB"}
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../src/src/duration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACzD,gDAAgD;AAChD,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC/C,gDAAgD;AAChD,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC/C,8CAA8C;AAC9C,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,6CAA6C;AAC7C,MAAM,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,8CAA8C;AAC9C,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,8CAA8C;AAC9C,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK,GAAU,IAAI,YAAY,KAAG,OAAO,CAAC,IAAI,CAE1D,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAQ;IACC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAAjD,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,QAAQ;IAIzD;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ;IAI1C;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ;IAI1C;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ;IAIpC;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ;IAIjC;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ;IAIpC;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ;IAIpC;;OAEG;IACH,cAAc,IAAI,YAAY;IAI9B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,OAAO,IAAI,KAAK;IAIhB;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,OAAO,IAAI,KAAK;IAIhB;;OAEG;IACH,OAAO,IAAI,KAAK;IAIhB;;;;;;;;OAQG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/esm/src/duration.js

@@ -1,3 +1,19 @@
+import * as dntShim from "../_dnt.shims.js";
+/**
+ * Sleeps for the given duration of milliseconds.
+ *
+ * @example Using `sleep` directly (for milliseconds).
+ * ```ts
+ * await sleep(1_000 as Milliseconds);
+ * ```
+ * @example Using `Duration.sleep` (for non-milliseconds).
+ * ```ts
+ * await Duration.seconds(1 as Seconds).sleep();
+ * ```
+ */
+export const sleep = async (ms) => {
+    await Duration.milliseconds(ms).sleep();
+};
 /**
  * A representation of a duration of time within a codebase.
  * This class provides a way to work with durations of time in a type-safe manner.
@@ -107,4 +123,16 @@ export class Duration {
     toYears() {
         return this.milliseconds / (365 * 24 * 60 * 60 * 1000);
     }
+    /**
+     * Sleeps for the current duration.
+     *
+     * @example
+     * ```ts
+     * const duration = Duration.seconds(5);
+     * await duration.sleep();
+     * ```
+     */
+    async sleep() {
+        await new Promise((resolve) => dntShim.setTimeout(resolve, this.toMilliseconds()));
+    }
 }

package/esm/src/numbers.d.ts

@@ -55,4 +55,88 @@ export declare function isOdd(num: number): boolean;
  * ```
  */
 export declare function ordinalize(num: number): string;
+/**
+ * Returns the maximum number from a list of numbers.
+ *
+ * @remarks
+ * This is `null | undefined` safe. If you pass `null | undefined` this will return `0`.
+ *
+ * @example
+ * ```ts
+ * max([]); // 0
+ * max([1]); // 1
+ * max([2, 3]); // 3
+ * max([4, 5, 6]); // 6
+ * max([11, 21, 112]); // 112
+ * ```
+ */
+export declare function max(nums: number[]): number;
+/**
+ * Returns the minimum number from a list of numbers.
+ *
+ * @remarks
+ * This is `null | undefined` safe. If you pass `null | undefined` this will return `0`.
+ *
+ * @example
+ * ```ts
+ * min([]); // 0
+ * min([1]); // 1
+ * min([2, 3]); // 2
+ * min([4, 5, 6]); // 4
+ * min([11, 21, 112]); // 11
+ * ```
+ */
+export declare function min(nums: number[]): number;
+/**
+ * Rounds a number to the nearest integer.
+ *
+ * @example
+ * ```ts
+ * round(null) // 0
+ * round(1.2); // 1
+ * round(1.5); // 2
+ * round(1.8); // 2
+ * round(2.2); // 2
+ * round(2.5); // 3
+ * round(2.8); // 3
+ * ```
+ */
+export declare function round(num: number): number;
+/**
+ * Returns the sum of a list of numbers.
+ *
+ * @remarks
+ * This is `null | undefined` safe. If you pass `null | undefined` this will return `0`.
+ *
+ * @example
+ * ```ts
+ * sum([1]); // 1
+ * sum([2, 3]); // 5
+ * sum([4, 5, 6]); // 15
+ * sum([11, 21, 112]); // 144
+ * ```
+ */
+export declare function sum(nums: number[]): number;
+/**
+ * Returns the average number from a list of numbers.
+ *
+ * @remarks
+ * This will include decimals, so you may want to use `Math.round`,
+ * `Math.floor` or `Math.ceil`.
+ *
+ * @example
+ * ```ts
+ * average([1]); // 1
+ * average([2, 3]); // 2.5
+ * average([4, 5, 6]); // 5
+ * average([11, 21, 112]); 48
+ * ```
+ * @example With a list of objects
+ * ```ts
+ * const people = [{ age: 20 }, { age: 18 }, { age: 19 }];
+ * const averageAge = average(people.map(({ age }) => age));
+ * console.log(averageAge); // 19
+ * ```
+ */
+export declare function average(nums: number[]): number;
 //# sourceMappingURL=numbers.d.ts.map

package/esm/src/numbers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../src/src/numbers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiB9C"}
+{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../src/src/numbers.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiB9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAG1C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAG1C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAG1C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAG9C"}

package/esm/src/numbers.js

@@ -1,3 +1,4 @@
+import { isEmpty } from "./core.js";
 /**
  * Determines if a number is even.
  *
@@ -74,3 +75,105 @@ export function ordinalize(num) {
             return num + "th";
     }
 }
+/**
+ * Returns the maximum number from a list of numbers.
+ *
+ * @remarks
+ * This is `null | undefined` safe. If you pass `null | undefined` this will return `0`.
+ *
+ * @example
+ * ```ts
+ * max([]); // 0
+ * max([1]); // 1
+ * max([2, 3]); // 3
+ * max([4, 5, 6]); // 6
+ * max([11, 21, 112]); // 112
+ * ```
+ */
+export function max(nums) {
+    if (isEmpty(nums))
+        return 0;
+    return Math.max(...nums);
+}
+/**
+ * Returns the minimum number from a list of numbers.
+ *
+ * @remarks
+ * This is `null | undefined` safe. If you pass `null | undefined` this will return `0`.
+ *
+ * @example
+ * ```ts
+ * min([]); // 0
+ * min([1]); // 1
+ * min([2, 3]); // 2
+ * min([4, 5, 6]); // 4
+ * min([11, 21, 112]); // 11
+ * ```
+ */
+export function min(nums) {
+    if (isEmpty(nums))
+        return 0;
+    return Math.min(...nums);
+}
+/**
+ * Rounds a number to the nearest integer.
+ *
+ * @example
+ * ```ts
+ * round(null) // 0
+ * round(1.2); // 1
+ * round(1.5); // 2
+ * round(1.8); // 2
+ * round(2.2); // 2
+ * round(2.5); // 3
+ * round(2.8); // 3
+ * ```
+ */
+export function round(num) {
+    return Math.round(num || 0);
+}
+/**
+ * Returns the sum of a list of numbers.
+ *
+ * @remarks
+ * This is `null | undefined` safe. If you pass `null | undefined` this will return `0`.
+ *
+ * @example
+ * ```ts
+ * sum([1]); // 1
+ * sum([2, 3]); // 5
+ * sum([4, 5, 6]); // 15
+ * sum([11, 21, 112]); // 144
+ * ```
+ */
+export function sum(nums) {
+    if (isEmpty(nums))
+        return 0;
+    return nums.reduce((acc, num) => acc + num, 0);
+}
+/**
+ * Returns the average number from a list of numbers.
+ *
+ * @remarks
+ * This will include decimals, so you may want to use `Math.round`,
+ * `Math.floor` or `Math.ceil`.
+ *
+ * @example
+ * ```ts
+ * average([1]); // 1
+ * average([2, 3]); // 2.5
+ * average([4, 5, 6]); // 5
+ * average([11, 21, 112]); 48
+ * ```
+ * @example With a list of objects
+ * ```ts
+ * const people = [{ age: 20 }, { age: 18 }, { age: 19 }];
+ * const averageAge = average(people.map(({ age }) => age));
+ * console.log(averageAge); // 19
+ * ```
+ */
+export function average(nums) {
+    if (isEmpty(nums))
+        return 0;
+    return sum(nums) / nums.length;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytebury/toolkit",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "TypeScript utility library to help energize your projects with useful functions for any size project. Save yourself some time and focus on shipping features.",
   "repository": {
     "type": "git",
@@ -19,10 +19,13 @@
     "test": "node test_runner.js"
   },
   "private": false,
+  "dependencies": {
+    "@deno/shim-deno": "~0.18.0",
+    "@deno/shim-timers": "~0.1.0"
+  },
   "devDependencies": {
     "@types/node": "^20.9.0",
-    "picocolors": "^1.0.0",
-    "@deno/shim-deno": "~0.18.0"
+    "picocolors": "^1.0.0"
   },
   "_generatedBy": "dnt@dev"
 }

package/script/_dnt.shims.d.ts

@@ -0,0 +1,10 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+import { setInterval, setTimeout } from "@deno/shim-timers";
+export { setInterval, setTimeout } from "@deno/shim-timers";
+export declare const dntGlobalThis: Omit<typeof globalThis, "setInterval" | "setTimeout" | "Deno"> & {
+    Deno: typeof Deno;
+    setInterval: typeof setInterval;
+    setTimeout: typeof setTimeout;
+};
+//# sourceMappingURL=_dnt.shims.d.ts.map

package/script/_dnt.shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.shims.d.ts","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAO5D,eAAO,MAAM,aAAa;;;;CAA2C,CAAC"}

package/script/_dnt.shims.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dntGlobalThis = exports.setTimeout = exports.setInterval = exports.Deno = void 0;
+const shim_deno_1 = require("@deno/shim-deno");
+var shim_deno_2 = require("@deno/shim-deno");
+Object.defineProperty(exports, "Deno", { enumerable: true, get: function () { return shim_deno_2.Deno; } });
+const shim_timers_1 = require("@deno/shim-timers");
+var shim_timers_2 = require("@deno/shim-timers");
+Object.defineProperty(exports, "setInterval", { enumerable: true, get: function () { return shim_timers_2.setInterval; } });
+Object.defineProperty(exports, "setTimeout", { enumerable: true, get: function () { return shim_timers_2.setTimeout; } });
+const dntGlobals = {
+    Deno: shim_deno_1.Deno,
+    setInterval: shim_timers_1.setInterval,
+    setTimeout: shim_timers_1.setTimeout,
+};
+exports.dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

package/script/_dnt.test_shims.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_dnt.test_shims.d.ts","sourceRoot":"","sources":["../src/_dnt.test_shims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAKvC,eAAO,MAAM,aAAa;;CAA2C,CAAC"}
+{"version":3,"file":"_dnt.test_shims.d.ts","sourceRoot":"","sources":["../src/_dnt.test_shims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAO5D,eAAO,MAAM,aAAa;;;;CAA2C,CAAC"}

package/script/src/core.d.ts

@@ -221,7 +221,7 @@ export declare function sample<T>(list: NonEmptyList<T>): T;
  * rand(3, 7); // 3 -> 6
  * ```
  */
-export declare function rand(start: number, end: number): number;
+export declare function random(start: number, end: number): number;
 /**
  * Determines if the given value is truthy.
  *
@@ -269,29 +269,33 @@ export declare function isSome(thing: unknown): boolean;
  */
 export declare function isNone(thing: unknown): boolean;
 /**
- * Sums the elements in the given list. If you pass a list of numbers, it sums
- * them directly. If you pass a list of objects, provide the key to sum.
+ * Returns a function that does nothing.
  *
  * @example
  * ```ts
- * sum([1, 2, 3]); // 6
- * sum([{ x: 1 }, { x: 2 }], "x"); // 3
+ * const doNothing = noop();
+ * doNothing(); // does nothing
  * ```
  */
-export declare function sum(list: number[]): number;
-export declare function sum<T extends Record<PropertyKey, number>>(list: T[], key: keyof T): number;
+export declare function noop(): void;
 /**
- * Calculates the average of the elements in the given list.
- * If you pass a list of numbers, it calculates the average directly.
- * If you pass a list of objects, provide the key to calculate the average.
+ * Returns true if the given value is within the given range.
  *
  * @example
  * ```ts
- * average([1, 2, 3]); // 2
- * average([{ x: 1 }, { x: 2 }], "x"); // 1.5
- * average([]); // 0
+ * inRange(5, 0, 10); // true
+ * inRange(0, 0, 10); // true
+ * inRange(10, 0, 10); // true
+ * inRange(11, 0, 10); // false
  * ```
  */
-export declare function average(list: number[]): number;
-export declare function average<T extends Record<PropertyKey, number>>(list: T[], key: keyof T): number;
+export declare function inRange(value: number, min: number, max: number): boolean;
+/**
+ * Splits an array into chunks of a fixed size.
+ *
+ * @example
+ * chunk([1,2,3,4,5,6,7], 3); // [[1,2,3],[4,5,6],[7]]
+ * chunk(['a','b','c','d'], 2); // [['a','b'], ['c','d']]
+ */
+export declare function chunk<T>(arr: T[], size: number): T[][];
 //# sourceMappingURL=core.d.ts.map

package/script/src/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/src/core.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/src/core.ts"],"names":[],"mappings":"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"}

package/script/src/core.js

@@ -14,13 +14,14 @@ exports.isNotEmpty = isNotEmpty;
 exports.unique = unique;
 exports.distinct = distinct;
 exports.sample = sample;
-exports.rand = rand;
+exports.random = random;
 exports.truthy = truthy;
 exports.falsy = falsy;
 exports.isSome = isSome;
 exports.isNone = isNone;
-exports.sum = sum;
-exports.average = average;
+exports.noop = noop;
+exports.inRange = inRange;
+exports.chunk = chunk;
 const strings_js_1 = require("./strings.js");
 /**
  * Clone an object using structuredClone.
@@ -192,7 +193,7 @@ function distinct(list) {
  * ```
  */
 function sample(list) {
-    return list[Math.floor(Math.random() * list.length)];
+    return list[random(0, list.length)];
 }
 /**
  * Gives a random number in the given range. The first parameter is inclusive
@@ -205,7 +206,7 @@ function sample(list) {
  * rand(3, 7); // 3 -> 6
  * ```
  */
-function rand(start, end) {
+function random(start, end) {
     return Math.floor(Math.random() * (end - start)) + start;
 }
 /**
@@ -262,18 +263,45 @@ function isSome(thing) {
 function isNone(thing) {
     return thing === null || thing === undefined;
 }
-// deno-lint-ignore no-explicit-any
-function sum(list, key) {
-    if (list.length === 0)
-        return 0;
-    if (typeof list[0] === "number") {
-        return list.reduce((a, v) => a + v, 0);
-    }
-    return list.reduce(
-    // deno-lint-ignore no-explicit-any
-    (a, v) => a + v[key], 0);
+/**
+ * Returns a function that does nothing.
+ *
+ * @example
+ * ```ts
+ * const doNothing = noop();
+ * doNothing(); // does nothing
+ * ```
+ */
+function noop() {
+    // Do nothing
 }
-// deno-lint-ignore no-explicit-any
-function average(list, key) {
-    return (sum(list, key) / list.length) || 0;
+/**
+ * Returns true if the given value is within the given range.
+ *
+ * @example
+ * ```ts
+ * inRange(5, 0, 10); // true
+ * inRange(0, 0, 10); // true
+ * inRange(10, 0, 10); // true
+ * inRange(11, 0, 10); // false
+ * ```
+ */
+function inRange(value, min, max) {
+    return value >= min && value <= max;
+}
+/**
+ * Splits an array into chunks of a fixed size.
+ *
+ * @example
+ * chunk([1,2,3,4,5,6,7], 3); // [[1,2,3],[4,5,6],[7]]
+ * chunk(['a','b','c','d'], 2); // [['a','b'], ['c','d']]
+ */
+function chunk(arr, size) {
+    if (size <= 0)
+        throw new Error("chunk size must be > 0");
+    const result = [];
+    for (let i = 0; i < arr.length; i += size) {
+        result.push(arr.slice(i, i + size));
+    }
+    return result;
 }

package/script/src/duration.d.ts

@@ -23,6 +23,19 @@ export type Days = Brand<number, "days">;
 export type Weeks = Brand<number, "weeks">;
 /** Represents a duration of time in years. */
 export type Years = Brand<number, "years">;
+/**
+ * Sleeps for the given duration of milliseconds.
+ *
+ * @example Using `sleep` directly (for milliseconds).
+ * ```ts
+ * await sleep(1_000 as Milliseconds);
+ * ```
+ * @example Using `Duration.sleep` (for non-milliseconds).
+ * ```ts
+ * await Duration.seconds(1 as Seconds).sleep();
+ * ```
+ */
+export declare const sleep: (ms: Milliseconds) => Promise<void>;
 /**
  * A representation of a duration of time within a codebase.
  * This class provides a way to work with durations of time in a type-safe manner.
@@ -98,5 +111,15 @@ export declare class Duration {
      * Converts the duration to years.
      */
     toYears(): Years;
+    /**
+     * Sleeps for the current duration.
+     *
+     * @example
+     * ```ts
+     * const duration = Duration.seconds(5);
+     * await duration.sleep();
+     * ```
+     */
+    sleep(): Promise<void>;
 }
 //# sourceMappingURL=duration.d.ts.map

package/script/src/duration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../src/src/duration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACzD,gDAAgD;AAChD,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC/C,gDAAgD;AAChD,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC/C,8CAA8C;AAC9C,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,6CAA6C;AAC7C,MAAM,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,8CAA8C;AAC9C,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,8CAA8C;AAC9C,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAQ;IACC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAAjD,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,QAAQ;IAIzD;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ;IAI1C;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ;IAI1C;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ;IAIpC;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ;IAIjC;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ;IAIpC;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ;IAIpC;;OAEG;IACH,cAAc,IAAI,YAAY;IAI9B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,OAAO,IAAI,KAAK;IAIhB;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,OAAO,IAAI,KAAK;IAIhB;;OAEG;IACH,OAAO,IAAI,KAAK;CAGjB"}
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../src/src/duration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACzD,gDAAgD;AAChD,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC/C,gDAAgD;AAChD,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC/C,8CAA8C;AAC9C,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,6CAA6C;AAC7C,MAAM,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,8CAA8C;AAC9C,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,8CAA8C;AAC9C,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK,GAAU,IAAI,YAAY,KAAG,OAAO,CAAC,IAAI,CAE1D,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAQ;IACC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAAjD,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,QAAQ;IAIzD;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ;IAI1C;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ;IAI1C;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ;IAIpC;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ;IAIjC;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ;IAIpC;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ;IAIpC;;OAEG;IACH,cAAc,IAAI,YAAY;IAI9B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,OAAO,IAAI,KAAK;IAIhB;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,OAAO,IAAI,KAAK;IAIhB;;OAEG;IACH,OAAO,IAAI,KAAK;IAIhB;;;;;;;;OAQG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/script/src/duration.js

@@ -1,6 +1,56 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Duration = void 0;
+exports.Duration = exports.sleep = void 0;
+const dntShim = __importStar(require("../_dnt.shims.js"));
+/**
+ * Sleeps for the given duration of milliseconds.
+ *
+ * @example Using `sleep` directly (for milliseconds).
+ * ```ts
+ * await sleep(1_000 as Milliseconds);
+ * ```
+ * @example Using `Duration.sleep` (for non-milliseconds).
+ * ```ts
+ * await Duration.seconds(1 as Seconds).sleep();
+ * ```
+ */
+const sleep = async (ms) => {
+    await Duration.milliseconds(ms).sleep();
+};
+exports.sleep = sleep;
 /**
  * A representation of a duration of time within a codebase.
  * This class provides a way to work with durations of time in a type-safe manner.
@@ -110,5 +160,17 @@ class Duration {
     toYears() {
         return this.milliseconds / (365 * 24 * 60 * 60 * 1000);
     }
+    /**
+     * Sleeps for the current duration.
+     *
+     * @example
+     * ```ts
+     * const duration = Duration.seconds(5);
+     * await duration.sleep();
+     * ```
+     */
+    async sleep() {
+        await new Promise((resolve) => dntShim.setTimeout(resolve, this.toMilliseconds()));
+    }
 }
 exports.Duration = Duration;

package/script/src/numbers.d.ts

@@ -55,4 +55,88 @@ export declare function isOdd(num: number): boolean;
  * ```
  */
 export declare function ordinalize(num: number): string;
+/**
+ * Returns the maximum number from a list of numbers.
+ *
+ * @remarks
+ * This is `null | undefined` safe. If you pass `null | undefined` this will return `0`.
+ *
+ * @example
+ * ```ts
+ * max([]); // 0
+ * max([1]); // 1
+ * max([2, 3]); // 3
+ * max([4, 5, 6]); // 6
+ * max([11, 21, 112]); // 112
+ * ```
+ */
+export declare function max(nums: number[]): number;
+/**
+ * Returns the minimum number from a list of numbers.
+ *
+ * @remarks
+ * This is `null | undefined` safe. If you pass `null | undefined` this will return `0`.
+ *
+ * @example
+ * ```ts
+ * min([]); // 0
+ * min([1]); // 1
+ * min([2, 3]); // 2
+ * min([4, 5, 6]); // 4
+ * min([11, 21, 112]); // 11
+ * ```
+ */
+export declare function min(nums: number[]): number;
+/**
+ * Rounds a number to the nearest integer.
+ *
+ * @example
+ * ```ts
+ * round(null) // 0
+ * round(1.2); // 1
+ * round(1.5); // 2
+ * round(1.8); // 2
+ * round(2.2); // 2
+ * round(2.5); // 3
+ * round(2.8); // 3
+ * ```
+ */
+export declare function round(num: number): number;
+/**
+ * Returns the sum of a list of numbers.
+ *
+ * @remarks
+ * This is `null | undefined` safe. If you pass `null | undefined` this will return `0`.
+ *
+ * @example
+ * ```ts
+ * sum([1]); // 1
+ * sum([2, 3]); // 5
+ * sum([4, 5, 6]); // 15
+ * sum([11, 21, 112]); // 144
+ * ```
+ */
+export declare function sum(nums: number[]): number;
+/**
+ * Returns the average number from a list of numbers.
+ *
+ * @remarks
+ * This will include decimals, so you may want to use `Math.round`,
+ * `Math.floor` or `Math.ceil`.
+ *
+ * @example
+ * ```ts
+ * average([1]); // 1
+ * average([2, 3]); // 2.5
+ * average([4, 5, 6]); // 5
+ * average([11, 21, 112]); 48
+ * ```
+ * @example With a list of objects
+ * ```ts
+ * const people = [{ age: 20 }, { age: 18 }, { age: 19 }];
+ * const averageAge = average(people.map(({ age }) => age));
+ * console.log(averageAge); // 19
+ * ```
+ */
+export declare function average(nums: number[]): number;
 //# sourceMappingURL=numbers.d.ts.map

package/script/src/numbers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../src/src/numbers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiB9C"}
+{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../src/src/numbers.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiB9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAG1C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAG1C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAG1C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAG9C"}

package/script/src/numbers.js

@@ -3,6 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isEven = isEven;
 exports.isOdd = isOdd;
 exports.ordinalize = ordinalize;
+exports.max = max;
+exports.min = min;
+exports.round = round;
+exports.sum = sum;
+exports.average = average;
+const core_js_1 = require("./core.js");
 /**
  * Determines if a number is even.
  *
@@ -79,3 +85,105 @@ function ordinalize(num) {
             return num + "th";
     }
 }
+/**
+ * Returns the maximum number from a list of numbers.
+ *
+ * @remarks
+ * This is `null | undefined` safe. If you pass `null | undefined` this will return `0`.
+ *
+ * @example
+ * ```ts
+ * max([]); // 0
+ * max([1]); // 1
+ * max([2, 3]); // 3
+ * max([4, 5, 6]); // 6
+ * max([11, 21, 112]); // 112
+ * ```
+ */
+function max(nums) {
+    if ((0, core_js_1.isEmpty)(nums))
+        return 0;
+    return Math.max(...nums);
+}
+/**
+ * Returns the minimum number from a list of numbers.
+ *
+ * @remarks
+ * This is `null | undefined` safe. If you pass `null | undefined` this will return `0`.
+ *
+ * @example
+ * ```ts
+ * min([]); // 0
+ * min([1]); // 1
+ * min([2, 3]); // 2
+ * min([4, 5, 6]); // 4
+ * min([11, 21, 112]); // 11
+ * ```
+ */
+function min(nums) {
+    if ((0, core_js_1.isEmpty)(nums))
+        return 0;
+    return Math.min(...nums);
+}
+/**
+ * Rounds a number to the nearest integer.
+ *
+ * @example
+ * ```ts
+ * round(null) // 0
+ * round(1.2); // 1
+ * round(1.5); // 2
+ * round(1.8); // 2
+ * round(2.2); // 2
+ * round(2.5); // 3
+ * round(2.8); // 3
+ * ```
+ */
+function round(num) {
+    return Math.round(num || 0);
+}
+/**
+ * Returns the sum of a list of numbers.
+ *
+ * @remarks
+ * This is `null | undefined` safe. If you pass `null | undefined` this will return `0`.
+ *
+ * @example
+ * ```ts
+ * sum([1]); // 1
+ * sum([2, 3]); // 5
+ * sum([4, 5, 6]); // 15
+ * sum([11, 21, 112]); // 144
+ * ```
+ */
+function sum(nums) {
+    if ((0, core_js_1.isEmpty)(nums))
+        return 0;
+    return nums.reduce((acc, num) => acc + num, 0);
+}
+/**
+ * Returns the average number from a list of numbers.
+ *
+ * @remarks
+ * This will include decimals, so you may want to use `Math.round`,
+ * `Math.floor` or `Math.ceil`.
+ *
+ * @example
+ * ```ts
+ * average([1]); // 1
+ * average([2, 3]); // 2.5
+ * average([4, 5, 6]); // 5
+ * average([11, 21, 112]); 48
+ * ```
+ * @example With a list of objects
+ * ```ts
+ * const people = [{ age: 20 }, { age: 18 }, { age: 19 }];
+ * const averageAge = average(people.map(({ age }) => age));
+ * console.log(averageAge); // 19
+ * ```
+ */
+function average(nums) {
+    if ((0, core_js_1.isEmpty)(nums))
+        return 0;
+    return sum(nums) / nums.length;
+}