@bytebury/toolkit 1.9.0 → 2.1.0

package/esm/src/dates.js

@@ -207,3 +207,21 @@ export function isInFuture(date) {
 export function isToday(date) {
     return !isInFuture(date) && !isInPast(date);
 }
+/**
+ * Determines if the date is yesterday.
+ *
+ * @remarks
+ * this is date specific. Time of day is ignored.
+ */
+export function isYesterday(date) {
+    return date >= yesterday() && date < today();
+}
+/**
+ * Determines if the date is tomorrow.
+ *
+ * @remarks
+ * this is date specific. Time of day is ignored.
+ */
+export function isTomorrow(date) {
+    return date >= tomorrow() && date < addDays(tomorrow(), 1);
+}

package/esm/src/numbers.d.ts

@@ -139,4 +139,67 @@ export declare function sum(nums: number[]): number;
  * ```
  */
 export declare function average(nums: number[]): number;
+/**
+ * Clamps a number between a minimum and maximum value.
+ *
+ * @example
+ * ```ts
+ * clamp(5, 0, 10); // 5
+ * clamp(-1, 0, 10); // 0
+ * clamp(15, 0, 10); // 10
+ * ```
+ */
+export declare function clamp(num: number, min: number, max: number): number;
+/**
+ * Returns the median value from a list of numbers.
+ *
+ * @remarks
+ * If you pass an empty list, this will return `0`.
+ *
+ * @example
+ * ```ts
+ * median([]); // 0
+ * median([1, 2, 3]); // 2
+ * median([1, 2, 3, 4]); // 2.5
+ * ```
+ */
+export declare function median(nums: number[]): number;
+/**
+ * Rounds a number to the given number of decimal places.
+ *
+ * @remarks
+ * This is `null | undefined` safe. If you pass `null | undefined` this will return `0`.
+ *
+ * @example
+ * ```ts
+ * roundTo(1.235, 2); // 1.24
+ * roundTo(1.5, 0); // 2
+ * roundTo(1234.5, -2); // 1200
+ * ```
+ */
+export declare function roundTo(num: number, decimals: number): number;
+/**
+ * Gives a random number in the given range. The first parameter is inclusive
+ * and the second one is exclusive. Therefore, it will work with lists out of
+ * the box.
+ *
+ * @example
+ * ```ts
+ * random(0, 10); // 0 -> 9
+ * random(3, 7); // 3 -> 6
+ * ```
+ */
+export declare function random(start: number, end: number): number;
+/**
+ * Returns true if the given value is within the given range (inclusive on both ends).
+ *
+ * @example
+ * ```ts
+ * inRange(5, 0, 10); // true
+ * inRange(0, 0, 10); // true
+ * inRange(10, 0, 10); // true
+ * inRange(11, 0, 10); // false
+ * ```
+ */
+export declare function inRange(value: number, min: number, max: number): boolean;
 //# 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":"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"}
+{"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;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAO7C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAExE"}

package/esm/src/numbers.js

@@ -177,3 +177,83 @@ export function average(nums) {
         return 0;
     return sum(nums) / nums.length;
 }
+/**
+ * Clamps a number between a minimum and maximum value.
+ *
+ * @example
+ * ```ts
+ * clamp(5, 0, 10); // 5
+ * clamp(-1, 0, 10); // 0
+ * clamp(15, 0, 10); // 10
+ * ```
+ */
+export function clamp(num, min, max) {
+    return Math.min(Math.max(num, min), max);
+}
+/**
+ * Returns the median value from a list of numbers.
+ *
+ * @remarks
+ * If you pass an empty list, this will return `0`.
+ *
+ * @example
+ * ```ts
+ * median([]); // 0
+ * median([1, 2, 3]); // 2
+ * median([1, 2, 3, 4]); // 2.5
+ * ```
+ */
+export function median(nums) {
+    if (isEmpty(nums))
+        return 0;
+    const sorted = [...nums].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    return sorted.length % 2 === 0
+        ? (sorted[mid - 1] + sorted[mid]) / 2
+        : sorted[mid];
+}
+/**
+ * Rounds a number to the given number of decimal places.
+ *
+ * @remarks
+ * This is `null | undefined` safe. If you pass `null | undefined` this will return `0`.
+ *
+ * @example
+ * ```ts
+ * roundTo(1.235, 2); // 1.24
+ * roundTo(1.5, 0); // 2
+ * roundTo(1234.5, -2); // 1200
+ * ```
+ */
+export function roundTo(num, decimals) {
+    const factor = Math.pow(10, decimals);
+    return Math.round((num || 0) * factor) / factor;
+}
+/**
+ * Gives a random number in the given range. The first parameter is inclusive
+ * and the second one is exclusive. Therefore, it will work with lists out of
+ * the box.
+ *
+ * @example
+ * ```ts
+ * random(0, 10); // 0 -> 9
+ * random(3, 7); // 3 -> 6
+ * ```
+ */
+export function random(start, end) {
+    return Math.floor(Math.random() * (end - start)) + start;
+}
+/**
+ * Returns true if the given value is within the given range (inclusive on both ends).
+ *
+ * @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;
+}

package/esm/src/objects.d.ts

@@ -0,0 +1,90 @@
+import type { None } from "./utility_types.js";
+/**
+ * Returns a strongly-typed array of an object's own enumerable keys.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an empty array.
+ *
+ * @example
+ * ```ts
+ * keys({ a: 1, b: 2 }); // ["a", "b"]
+ * keys({}); // []
+ * keys(null); // []
+ * ```
+ */
+export declare function keys<T extends Record<string, unknown>>(obj: T | None): (keyof T)[];
+/**
+ * Returns a strongly-typed array of an object's own enumerable `[key, value]` pairs.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an empty array.
+ *
+ * @example
+ * ```ts
+ * entries({ a: 1, b: 2 }); // [["a", 1], ["b", 2]]
+ * entries({}); // []
+ * entries(null); // []
+ * ```
+ */
+export declare function entries<T extends Record<string, unknown>>(obj: T | None): [keyof T, T[keyof T]][];
+/**
+ * Returns a new object containing only the specified keys. Keys that are not
+ * present on the source object are silently ignored.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an empty object.
+ *
+ * @example
+ * ```ts
+ * pick({ a: 1, b: 2, c: 3 }, ["a", "c"]); // { a: 1, c: 3 }
+ * pick({ a: 1, b: 2 }, []); // {}
+ * pick(null, ["a"]); // {}
+ * ```
+ */
+export declare function pick<T extends Record<string, unknown>, K extends keyof T>(obj: T | None, keys: K[]): Pick<T, K>;
+/**
+ * Returns a new object with the specified keys excluded.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an empty object.
+ *
+ * @example
+ * ```ts
+ * omit({ a: 1, b: 2, c: 3 }, ["a"]); // { b: 2, c: 3 }
+ * omit({ a: 1, b: 2 }, []); // { a: 1, b: 2 }
+ * omit(null, ["a"]); // {}
+ * ```
+ */
+export declare function omit<T extends Record<string, unknown>, K extends keyof T>(obj: T | None, keys: K[]): Omit<T, K>;
+/**
+ * Returns a new object with the same keys, where each value is transformed by `fn`.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an empty object.
+ *
+ * @example
+ * ```ts
+ * mapValues({ a: 1, b: 2 }, (v) => v * 2); // { a: 2, b: 4 }
+ * mapValues({ a: 1, b: 2 }, (v, k) => `${k}=${v}`); // { a: "a=1", b: "b=2" }
+ * mapValues(null, (v) => v); // {}
+ * ```
+ */
+export declare function mapValues<T extends Record<string, unknown>, V>(obj: T | None, fn: (value: T[keyof T], key: keyof T) => V): {
+    [K in keyof T]: V;
+};
+/**
+ * Returns a new object with each key transformed by `fn`. Values are unchanged.
+ * If `fn` produces duplicate keys, later entries overwrite earlier ones.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an empty object.
+ *
+ * @example
+ * ```ts
+ * mapKeys({ a: 1, b: 2 }, (k) => k.toUpperCase()); // { A: 1, B: 2 }
+ * mapKeys({ first: "Bob", last: "Lee" }, (k) => `user_${k}`); // { user_first: "Bob", user_last: "Lee" }
+ * mapKeys(null, (k) => k); // {}
+ * ```
+ */
+export declare function mapKeys<T extends Record<string, unknown>>(obj: T | None, fn: (key: keyof T, value: T[keyof T]) => string): Record<string, T[keyof T]>;
+//# sourceMappingURL=objects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../src/src/objects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpD,GAAG,EAAE,CAAC,GAAG,IAAI,GACZ,CAAC,MAAM,CAAC,CAAC,EAAE,CAGb;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,GAAG,EAAE,CAAC,GAAG,IAAI,GACZ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAGzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACvE,GAAG,EAAE,CAAC,GAAG,IAAI,EACb,IAAI,EAAE,CAAC,EAAE,GACR,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAOZ;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACvE,GAAG,EAAE,CAAC,GAAG,IAAI,EACb,IAAI,EAAE,CAAC,EAAE,GACR,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAQZ;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAC5D,GAAG,EAAE,CAAC,GAAG,IAAI,EACb,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GACzC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC;CAAE,CAOvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,GAAG,EAAE,CAAC,GAAG,IAAI,EACb,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,MAAM,GAC9C,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAO5B"}

package/esm/src/objects.js

@@ -0,0 +1,129 @@
+/**
+ * Returns a strongly-typed array of an object's own enumerable keys.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an empty array.
+ *
+ * @example
+ * ```ts
+ * keys({ a: 1, b: 2 }); // ["a", "b"]
+ * keys({}); // []
+ * keys(null); // []
+ * ```
+ */
+export function keys(obj) {
+    if (obj == null)
+        return [];
+    return Object.keys(obj);
+}
+/**
+ * Returns a strongly-typed array of an object's own enumerable `[key, value]` pairs.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an empty array.
+ *
+ * @example
+ * ```ts
+ * entries({ a: 1, b: 2 }); // [["a", 1], ["b", 2]]
+ * entries({}); // []
+ * entries(null); // []
+ * ```
+ */
+export function entries(obj) {
+    if (obj == null)
+        return [];
+    return Object.entries(obj);
+}
+/**
+ * Returns a new object containing only the specified keys. Keys that are not
+ * present on the source object are silently ignored.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an empty object.
+ *
+ * @example
+ * ```ts
+ * pick({ a: 1, b: 2, c: 3 }, ["a", "c"]); // { a: 1, c: 3 }
+ * pick({ a: 1, b: 2 }, []); // {}
+ * pick(null, ["a"]); // {}
+ * ```
+ */
+export function pick(obj, keys) {
+    if (obj == null)
+        return {};
+    const result = {};
+    for (const key of keys) {
+        if (key in obj)
+            result[key] = obj[key];
+    }
+    return result;
+}
+/**
+ * Returns a new object with the specified keys excluded.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an empty object.
+ *
+ * @example
+ * ```ts
+ * omit({ a: 1, b: 2, c: 3 }, ["a"]); // { b: 2, c: 3 }
+ * omit({ a: 1, b: 2 }, []); // { a: 1, b: 2 }
+ * omit(null, ["a"]); // {}
+ * ```
+ */
+export function omit(obj, keys) {
+    if (obj == null)
+        return {};
+    const excluded = new Set(keys);
+    const result = {};
+    for (const key of Object.keys(obj)) {
+        if (!excluded.has(key))
+            result[key] = obj[key];
+    }
+    return result;
+}
+/**
+ * Returns a new object with the same keys, where each value is transformed by `fn`.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an empty object.
+ *
+ * @example
+ * ```ts
+ * mapValues({ a: 1, b: 2 }, (v) => v * 2); // { a: 2, b: 4 }
+ * mapValues({ a: 1, b: 2 }, (v, k) => `${k}=${v}`); // { a: "a=1", b: "b=2" }
+ * mapValues(null, (v) => v); // {}
+ * ```
+ */
+export function mapValues(obj, fn) {
+    if (obj == null)
+        return {};
+    const result = {};
+    for (const key of Object.keys(obj)) {
+        result[key] = fn(obj[key], key);
+    }
+    return result;
+}
+/**
+ * Returns a new object with each key transformed by `fn`. Values are unchanged.
+ * If `fn` produces duplicate keys, later entries overwrite earlier ones.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an empty object.
+ *
+ * @example
+ * ```ts
+ * mapKeys({ a: 1, b: 2 }, (k) => k.toUpperCase()); // { A: 1, B: 2 }
+ * mapKeys({ first: "Bob", last: "Lee" }, (k) => `user_${k}`); // { user_first: "Bob", user_last: "Lee" }
+ * mapKeys(null, (k) => k); // {}
+ * ```
+ */
+export function mapKeys(obj, fn) {
+    if (obj == null)
+        return {};
+    const result = {};
+    for (const key of Object.keys(obj)) {
+        result[fn(key, obj[key])] = obj[key];
+    }
+    return result;
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"objects_test.d.ts","sourceRoot":"","sources":["../../src/src/objects_test.ts"],"names":[],"mappings":"AAAA,OAAO,2BAA2B,CAAC"}

package/esm/src/strings.d.ts

@@ -15,6 +15,10 @@
  * ```
  */
 export declare function isWhitespace(text: string): boolean;
+/**
+ * Alias for `isWhitespace`.
+ */
+export declare function isNoneOrWhitespace(text: string): boolean;
 /**
  * Determines if the given text contains any non-whitespace characters.
  *
@@ -29,6 +33,10 @@ export declare function isWhitespace(text: string): boolean;
  * ```
  */
 export declare function isNotWhitespace(text: string): boolean;
+/**
+ * Alias for `isNotWhitespace`.
+ */
+export declare function isNotNoneOrWhitespace(text: string): boolean;
 /**
  * Trims the whitespace from the beginning and the end. This is an
  * alias for `.trim()`. Useful for when you're mapping over lists.
@@ -163,4 +171,66 @@ export declare function keepAlphanumeric(text: string): string;
  * ```
  */
 export declare function keepNumeric(text: string): string;
+/**
+ * Converts the string to `camelCase` by removing punctuation, trimming extra
+ * spaces, and lowercasing the first word with subsequent words capitalized.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an Empty String.
+ *
+ * @example
+ * ```ts
+ * camel(null); // ""
+ * camel("Hello World"); // "helloWorld"
+ * camel("user_profile_page"); // "userProfilePage"
+ * camel("HELLO-WORLD"); // "helloWorld"
+ * ```
+ */
+export declare function camel(text: string): string;
+/**
+ * Converts the string to `PascalCase` by removing punctuation, trimming extra
+ * spaces, and capitalizing every word.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an Empty String.
+ *
+ * @example
+ * ```ts
+ * pascal(null); // ""
+ * pascal("hello world"); // "HelloWorld"
+ * pascal("user_profile_page"); // "UserProfilePage"
+ * ```
+ */
+export declare function pascal(text: string): string;
+/**
+ * Truncates a string to the given length. If truncation occurs, the suffix is
+ * appended and counted toward the total length.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an Empty String.
+ *
+ * @example
+ * ```ts
+ * truncate(null, 10); // ""
+ * truncate("Hello World", 5); // "He..."
+ * truncate("Hello World", 20); // "Hello World"
+ * truncate("Hello World", 8, "…"); // "Hello W…"
+ * ```
+ */
+export declare function truncate(text: string, length: number, suffix?: string): string;
+/**
+ * Converts a string to a URL-safe slug. Diacritics are stripped, punctuation is
+ * removed, and whitespace is replaced with hyphens.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an Empty String.
+ *
+ * @example
+ * ```ts
+ * slugify(null); // ""
+ * slugify("Hello World!"); // "hello-world"
+ * slugify("Café à la Carte"); // "cafe-a-la-carte"
+ * ```
+ */
+export declare function slugify(text: string): string;
 //# sourceMappingURL=strings.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/src/strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAErD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAErD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAIrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAErD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD"}
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/src/strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAErD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAErD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAIrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAErD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK1C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM3C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAQ,GAAG,MAAM,CAI7E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/esm/src/strings.js

@@ -17,6 +17,12 @@
 export function isWhitespace(text) {
     return trim(text).length === 0;
 }
+/**
+ * Alias for `isWhitespace`.
+ */
+export function isNoneOrWhitespace(text) {
+    return isWhitespace(text);
+}
 /**
  * Determines if the given text contains any non-whitespace characters.
  *
@@ -33,6 +39,12 @@ export function isWhitespace(text) {
 export function isNotWhitespace(text) {
     return !isWhitespace(text);
 }
+/**
+ * Alias for `isNotWhitespace`.
+ */
+export function isNotNoneOrWhitespace(text) {
+    return isNotWhitespace(text);
+}
 /**
  * Trims the whitespace from the beginning and the end. This is an
  * alias for `.trim()`. Useful for when you're mapping over lists.
@@ -189,6 +201,87 @@ export function keepAlphanumeric(text) {
 export function keepNumeric(text) {
     return (text || "").replace(/[^\d]/g, "");
 }
+/**
+ * Converts the string to `camelCase` by removing punctuation, trimming extra
+ * spaces, and lowercasing the first word with subsequent words capitalized.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an Empty String.
+ *
+ * @example
+ * ```ts
+ * camel(null); // ""
+ * camel("Hello World"); // "helloWorld"
+ * camel("user_profile_page"); // "userProfilePage"
+ * camel("HELLO-WORLD"); // "helloWorld"
+ * ```
+ */
+export function camel(text) {
+    const parts = kebab(text).split("-").filter(Boolean);
+    if (parts.length === 0)
+        return "";
+    return parts[0] +
+        parts.slice(1).map((p) => upper(p[0]) + p.slice(1)).join("");
+}
+/**
+ * Converts the string to `PascalCase` by removing punctuation, trimming extra
+ * spaces, and capitalizing every word.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an Empty String.
+ *
+ * @example
+ * ```ts
+ * pascal(null); // ""
+ * pascal("hello world"); // "HelloWorld"
+ * pascal("user_profile_page"); // "UserProfilePage"
+ * ```
+ */
+export function pascal(text) {
+    return kebab(text)
+        .split("-")
+        .filter(Boolean)
+        .map((p) => upper(p[0]) + p.slice(1))
+        .join("");
+}
+/**
+ * Truncates a string to the given length. If truncation occurs, the suffix is
+ * appended and counted toward the total length.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an Empty String.
+ *
+ * @example
+ * ```ts
+ * truncate(null, 10); // ""
+ * truncate("Hello World", 5); // "He..."
+ * truncate("Hello World", 20); // "Hello World"
+ * truncate("Hello World", 8, "…"); // "Hello W…"
+ * ```
+ */
+export function truncate(text, length, suffix = "...") {
+    const t = text || "";
+    if (t.length <= length)
+        return t;
+    return t.slice(0, Math.max(0, length - suffix.length)) + suffix;
+}
+/**
+ * Converts a string to a URL-safe slug. Diacritics are stripped, punctuation is
+ * removed, and whitespace is replaced with hyphens.
+ *
+ * @remarks
+ * This is `None` safe. If you pass `null | undefined` then this will return an Empty String.
+ *
+ * @example
+ * ```ts
+ * slugify(null); // ""
+ * slugify("Hello World!"); // "hello-world"
+ * slugify("Café à la Carte"); // "cafe-a-la-carte"
+ * ```
+ */
+export function slugify(text) {
+    return kebab(text);
+}
 function removePunctuation(text) {
     return text
         .normalize("NFKD")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytebury/toolkit",
-  "version": "1.9.0",
+  "version": "2.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",
@@ -13,12 +13,41 @@
     ".": {
       "import": "./esm/mod.js",
       "require": "./script/mod.js"
+    },
+    "./core": {
+      "import": "./esm/src/core.js",
+      "require": "./script/src/core.js"
+    },
+    "./dates": {
+      "import": "./esm/src/dates.js",
+      "require": "./script/src/dates.js"
+    },
+    "./duration": {
+      "import": "./esm/src/duration.js",
+      "require": "./script/src/duration.js"
+    },
+    "./numbers": {
+      "import": "./esm/src/numbers.js",
+      "require": "./script/src/numbers.js"
+    },
+    "./objects": {
+      "import": "./esm/src/objects.js",
+      "require": "./script/src/objects.js"
+    },
+    "./strings": {
+      "import": "./esm/src/strings.js",
+      "require": "./script/src/strings.js"
+    },
+    "./utility-types": {
+      "import": "./esm/src/utility_types.js",
+      "require": "./script/src/utility_types.js"
     }
   },
   "scripts": {
     "test": "node test_runner.js"
   },
   "private": false,
+  "sideEffects": false,
   "devDependencies": {
     "@types/node": "^20.9.0",
     "picocolors": "^1.0.0",

package/script/deps/jsr.io/@std/internal/{1.0.13 → 1.0.14}/build_message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build_message.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/internal/1.0.13/build_message.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ;AAClB;;;GAGG;AACH,UAAU,UAAQ,GACjB,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAWvB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CASrD;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAC7C,OAAO,GAAE,mBAAwB,EACjC,YAAY,CAAC,EAAE,CACb,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAC7C,UAAU,EAAE,OAAO,EACnB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,KAC1B,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,GACrC,MAAM,EAAE,CA8BV"}
+{"version":3,"file":"build_message.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/internal/1.0.14/build_message.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ;AAClB;;;GAGG;AACH,UAAU,UAAQ,GACjB,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAWvB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CASrD;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAC7C,OAAO,GAAE,mBAAwB,EACjC,YAAY,CAAC,EAAE,CACb,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAC7C,UAAU,EAAE,OAAO,EACnB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,KAC1B,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,GACrC,MAAM,EAAE,CA8BV"}

package/{esm/deps/jsr.io/@std/internal/1.0.13 → script/deps/jsr.io/@std/internal/1.0.14}/diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/internal/1.0.13/diff.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvD,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,CAAC,EAAE,MAAM,CAAC;IACV,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;CACZ;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAanD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAWvE;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,CAAC,EAAE,CAAC,EAAE,EACN,CAAC,EAAE,CAAC,EAAE,EACN,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,EACnB,kBAAkB,EAAE,MAAM,GACzB,KAAK,CAAC;IACP,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,CAAC,CAAC;CACV,CAAC,CAgCD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,QAAQ,CACtB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,WAAW,EACnB,kBAAkB,EAAE,MAAM,EAC1B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,aAAa,EACrB,IAAI,CAAC,EAAE,aAAa,GACnB,aAAa,CAsBf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAwEvD"}
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/internal/1.0.14/diff.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvD,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,CAAC,EAAE,MAAM,CAAC;IACV,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;CACZ;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAanD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAWvE;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,CAAC,EAAE,CAAC,EAAE,EACN,CAAC,EAAE,CAAC,EAAE,EACN,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,EACnB,kBAAkB,EAAE,MAAM,GACzB,KAAK,CAAC;IACP,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,CAAC,CAAC;CACV,CAAC,CAiCD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,QAAQ,CACtB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,WAAW,EACnB,kBAAkB,EAAE,MAAM,EAC1B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,aAAa,EACrB,IAAI,CAAC,EAAE,aAAa,GACnB,aAAa,CAsBf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAwEvD"}