@oviirup/utils 1.0.6 → 1.0.7

package/dist/array/index.d.ts

@@ -1,5 +1,5 @@
 declare namespace index_d_exports {
-  export { at, first, last, move, range, toArray, toFiltered, unique };
+  export { at, chunk, first, last, move, range, toArray, toFiltered, unique };
 }
 /**
  * Converts a given value to represent itself in an array
@@ -58,5 +58,12 @@ declare function toFiltered<T>(array: T[], predicate: Predicate<T>): T[];
  * @category Array
  */
 declare function move<T>(array: T[], from: number, to: number): T[];
+/**
+ * Chunk an array into smaller arrays of a given size
+ * @param array The array to chunk
+ * @param size The size of the chunks
+ * @category Array
+ */
+declare function chunk<T>(array: T[], size: number): T[][];
 //#endregion
-export { at, first, last, move, range, index_d_exports as t, toArray, toFiltered, unique };
+export { at, chunk, first, last, move, range, index_d_exports as t, toArray, toFiltered, unique };

package/dist/array/index.js

@@ -1,9 +1,10 @@
-import { t as __exportAll } from "../chunk-BN_g-Awi.js";
+import { t as __exportAll } from "../chunk-BYypO7fO.js";
 import { isEmptyArray } from "../assertions/index.js";
 
 //#region src/array/index.ts
 var array_exports = /* @__PURE__ */ __exportAll({
 	at: () => at,
+	chunk: () => chunk,
 	first: () => first,
 	last: () => last,
 	move: () => move,
@@ -79,6 +80,20 @@ function move(array, from, to) {
 	array.splice(to, 0, item);
 	return array;
 }
+/**
+* Chunk an array into smaller arrays of a given size
+* @param array The array to chunk
+* @param size The size of the chunks
+* @category Array
+*/
+function chunk(array, size) {
+	return array.reduce((acc, item, index) => {
+		const chunkIndex = Math.floor(index / size);
+		if (!acc[chunkIndex]) acc[chunkIndex] = [];
+		acc[chunkIndex].push(item);
+		return acc;
+	}, []);
+}
 
 //#endregion
-export { at, first, last, move, range, array_exports as t, toArray, toFiltered, unique };
+export { at, chunk, first, last, move, range, array_exports as t, toArray, toFiltered, unique };

package/dist/assertions/index.d.ts

@@ -1,4 +1,4 @@
-import { a as Dictionary, o as NegatePredicate, r as AnyFunction, s as Predicate } from "../types-C7M9sZlw.js";
+import { AnyFunction, Dictionary, NegatePredicate, Predicate } from "../types.js";
 
 //#region src/assertions/index.d.ts
 /** Check if given value is a string */

package/dist/{chunk-BN_g-Awi.js → chunk-BYypO7fO.js}

@@ -1,6 +1,6 @@
-//#region rolldown:runtime
+//#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
-var __exportAll = (all, symbols) => {
+var __exportAll = (all, no_symbols) => {
 	let target = {};
 	for (var name in all) {
 		__defProp(target, name, {
@@ -8,7 +8,7 @@ var __exportAll = (all, symbols) => {
 			enumerable: true
 		});
 	}
-	if (symbols) {
+	if (!no_symbols) {
 		__defProp(target, Symbol.toStringTag, { value: "Module" });
 	}
 	return target;

package/dist/clsx/index.d.ts

@@ -1,4 +1,4 @@
-import { i as ClassNameValue } from "../types-C7M9sZlw.js";
+import { ClassNameValue } from "../types.js";
 
 //#region src/clsx/index.d.ts
 /**

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import { t as index_d_exports } from "./array/index.js";
-import { i as ClassNameValue } from "./types-C7M9sZlw.js";
+import { ClassNameValue } from "./types.js";
 import { isArray, isBrowser, isEmpty, isEmptyArray, isEmptyObject, isFloat, isFunction, isInteger, isNumber, isObject, isRegex, isString, isTruthy, not } from "./assertions/index.js";
 import { clsx } from "./clsx/index.js";
 import { charset, nanoid } from "./nanoid/index.js";
 import { t as index_d_exports$1 } from "./number/index.js";
 import { t as object_d_exports } from "./object.js";
-import { t as promise_d_exports } from "./promise.js";
-import { t as index_d_exports$2 } from "./string/index.js";
-export { ClassNameValue, index_d_exports as array, charset, clsx, isArray, isBrowser, isEmpty, isEmptyArray, isEmptyObject, isFloat, isFunction, isInteger, isNumber, isObject, isRegex, isString, isTruthy, nanoid, not, index_d_exports$1 as number, object_d_exports as object, promise_d_exports as promise, index_d_exports$2 as string };
+import { t as index_d_exports$2 } from "./promise/index.js";
+import { t as index_d_exports$3 } from "./string/index.js";
+export { ClassNameValue, index_d_exports as array, charset, clsx, isArray, isBrowser, isEmpty, isEmptyArray, isEmptyObject, isFloat, isFunction, isInteger, isNumber, isObject, isRegex, isString, isTruthy, nanoid, not, index_d_exports$1 as number, object_d_exports as object, index_d_exports$2 as promise, index_d_exports$3 as string };

package/dist/index.js

@@ -4,7 +4,7 @@ import { clsx } from "./clsx/index.js";
 import { charset, nanoid } from "./nanoid/index.js";
 import { t as number_exports } from "./number/index.js";
 import { t as object_exports } from "./object.js";
-import { t as promise_exports } from "./promise.js";
+import { t as promise_exports } from "./promise/index.js";
 import { t as string_exports } from "./string/index.js";
 
 export { array_exports as array, charset, clsx, isArray, isBrowser, isEmpty, isEmptyArray, isEmptyObject, isFloat, isFunction, isInteger, isNumber, isObject, isRegex, isString, isTruthy, nanoid, not, number_exports as number, object_exports as object, promise_exports as promise, string_exports as string };

package/dist/number/index.d.ts

@@ -1,4 +1,4 @@
-import { n as AbbreviationSymbols, t as AbbreviateOptions } from "../types-C7M9sZlw.js";
+import { AbbreviateOptions, AbbreviationSymbols } from "../types.js";
 
 //#region src/number/index.d.ts
 declare namespace index_d_exports {

package/dist/number/index.js

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "../chunk-BN_g-Awi.js";
+import { t as __exportAll } from "../chunk-BYypO7fO.js";
 import { isNumber, isObject } from "../assertions/index.js";
 
 //#region src/number/index.ts

package/dist/object.d.ts

@@ -1,4 +1,4 @@
-import { a as Dictionary } from "./types-C7M9sZlw.js";
+import { Dictionary } from "./types.js";
 
 //#region src/object.d.ts
 declare namespace object_d_exports {

package/dist/object.js

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "./chunk-BN_g-Awi.js";
+import { t as __exportAll } from "./chunk-BYypO7fO.js";
 import { isObject } from "./assertions/index.js";
 import { toArray } from "./array/index.js";
 

package/dist/promise/index.d.ts

@@ -0,0 +1,31 @@
+import { MaybePromise } from "../types.js";
+
+//#region src/promise/index.d.ts
+declare namespace index_d_exports {
+  export { retry, sleep, tryCatch };
+}
+/**
+ * Delays execution for a specified number of milliseconds
+ * @param delay The delay in milliseconds (must be a positive finite number)
+ * @returns A promise that resolves after the specified delay
+ * @category promise
+ */
+declare function sleep(delay: number): Promise<void>;
+/**
+ * Retries a function until it succeeds or the maximum number of retries is reached
+ * @param func The function to retry
+ * @param retries The number of retries
+ * @param delay The delay between retries (optional)
+ * @returns The result of the function
+ * @category promise
+ */
+declare function retry<T>(func: () => Promise<T>, retries: number, delay?: number): Promise<T>;
+/**
+ * Wraps a promise or function and returns a result object with discriminated union
+ * @param input A promise or function that returns a promise/value
+ * @returns A tuple [value, error] where value is the result or null, and error is undefined or the error
+ * @category promise
+ */
+declare function tryCatch<T, E = Error>(input: Promise<T> | (() => MaybePromise<T>)): Promise<readonly [Awaited<T>, undefined] | readonly [null, E]>;
+//#endregion
+export { retry, sleep, index_d_exports as t, tryCatch };

package/dist/promise/index.js

@@ -0,0 +1,56 @@
+import { t as __exportAll } from "../chunk-BYypO7fO.js";
+import { isNumber } from "../assertions/index.js";
+
+//#region src/promise/index.ts
+var promise_exports = /* @__PURE__ */ __exportAll({
+	retry: () => retry,
+	sleep: () => sleep,
+	tryCatch: () => tryCatch
+});
+/**
+* Delays execution for a specified number of milliseconds
+* @param delay The delay in milliseconds (must be a positive finite number)
+* @returns A promise that resolves after the specified delay
+* @category promise
+*/
+function sleep(delay) {
+	if (!isNumber(delay)) throw new TypeError("sleep: delay must be a number");
+	else if (!Number.isFinite(delay) || delay < 0) throw new RangeError("sleep: delay must be a positive finite number");
+	if (delay === 0) return Promise.resolve();
+	return new Promise((resolve) => setTimeout(resolve, delay));
+}
+/**
+* Retries a function until it succeeds or the maximum number of retries is reached
+* @param func The function to retry
+* @param retries The number of retries
+* @param delay The delay between retries (optional)
+* @returns The result of the function
+* @category promise
+*/
+async function retry(func, retries, delay = 0) {
+	try {
+		return await func();
+	} catch (error) {
+		if (retries > 0) {
+			await sleep(delay);
+			return retry(func, retries - 1, delay);
+		}
+		throw error;
+	}
+}
+/**
+* Wraps a promise or function and returns a result object with discriminated union
+* @param input A promise or function that returns a promise/value
+* @returns A tuple [value, error] where value is the result or null, and error is undefined or the error
+* @category promise
+*/
+async function tryCatch(input) {
+	try {
+		return [typeof input === "function" ? await input() : await input, void 0];
+	} catch (error) {
+		return [null, error];
+	}
+}
+
+//#endregion
+export { retry, sleep, promise_exports as t, tryCatch };

package/dist/string/index.js

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "../chunk-BN_g-Awi.js";
+import { t as __exportAll } from "../chunk-BYypO7fO.js";
 
 //#region src/string/index.ts
 var string_exports = /* @__PURE__ */ __exportAll({

package/dist/types.d.ts

@@ -1,2 +1,17 @@
-import { a as Dictionary, i as ClassNameValue, n as AbbreviationSymbols, o as NegatePredicate, r as AnyFunction, s as Predicate, t as AbbreviateOptions } from "./types-C7M9sZlw.js";
-export { AbbreviateOptions, AbbreviationSymbols, AnyFunction, ClassNameValue, Dictionary, NegatePredicate, Predicate };
+//#region src/types.d.ts
+type Dictionary<T = any> = Record<string, T>;
+type AnyFunction<T = any> = (...args: any[]) => T;
+type ClassValue = string | number | bigint | null | boolean | undefined;
+type ClassArray = ClassValue[];
+type ClassRecord = Record<string, any>;
+type ClassNameValue = ClassValue | ClassArray | ClassRecord;
+type AbbreviationSymbols = Dictionary<number> | string[];
+type AbbreviateOptions = {
+  symbols?: AbbreviationSymbols;
+  precision?: number;
+};
+type Predicate = ((val: unknown) => boolean) | ((val: unknown) => val is unknown);
+type NegatePredicate<T> = T extends ((val: unknown) => val is infer U) ? <V>(val: V) => val is Exclude<V, U> : T extends ((val: unknown) => boolean) ? (val: unknown) => boolean : never;
+type MaybePromise<T> = T | Promise<T>;
+//#endregion
+export { AbbreviateOptions, AbbreviationSymbols, AnyFunction, ClassNameValue, Dictionary, MaybePromise, NegatePredicate, Predicate };

package/dist/types.ts

@@ -23,3 +23,5 @@ export type NegatePredicate<T> = T extends (val: unknown) => val is infer U
   : T extends (val: unknown) => boolean
     ? (val: unknown) => boolean
     : never;
+
+export type MaybePromise<T> = T | Promise<T>;

package/license

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Avirup Ghosh
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Avirup Ghosh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oviirup/utils",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Collection of common JavaScript / TypeScript utilities bt @oviirup",
   "license": "MIT",
   "repository": "https://github.com/oviirup/utils",
@@ -14,7 +14,7 @@
     "./nanoid": "./dist/nanoid/index.js",
     "./number": "./dist/number/index.js",
     "./object": "./dist/object.js",
-    "./promise": "./dist/promise.js",
+    "./promise": "./dist/promise/index.js",
     "./string": "./dist/string/index.js",
     "./string/casing": "./dist/string/casing.js",
     "./types": "./dist/types.js",
@@ -29,10 +29,12 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.13",
-    "@types/bun": "^1.3.8",
-    "lefthook": "^2.0.16",
-    "tsdown": "^0.20.1",
+    "@biomejs/biome": "^2.3.14",
+    "@changesets/changelog-github": "^0.5.2",
+    "@changesets/cli": "^2.29.8",
+    "@types/bun": "^1.3.9",
+    "lefthook": "^2.1.0",
+    "tsdown": "^0.20.3",
     "typescript": "^5.9.3"
   },
   "publishConfig": {

package/dist/promise.d.ts

@@ -1,14 +0,0 @@
-declare namespace promise_d_exports {
-  export { retry, sleep };
-}
-declare function sleep(delay: number): Promise<void>;
-/**
- * Retries a function until it succeeds or the maximum number of retries is reached
- * @param func The function to retry
- * @param retries The number of retries
- * @param delay The delay between retries (optional)
- * @returns The result of the function
- */
-declare function retry<T>(func: () => Promise<T>, retries: number, delay?: number): Promise<T>;
-//#endregion
-export { retry, sleep, promise_d_exports as t };

package/dist/promise.js

@@ -1,35 +0,0 @@
-import { t as __exportAll } from "./chunk-BN_g-Awi.js";
-import { isNumber } from "./assertions/index.js";
-
-//#region src/promise.ts
-var promise_exports = /* @__PURE__ */ __exportAll({
-	retry: () => retry,
-	sleep: () => sleep
-});
-function sleep(delay) {
-	if (!isNumber(delay)) throw new TypeError("sleep: delay must be a number");
-	else if (!Number.isFinite(delay) || delay < 0) throw new RangeError("sleep: delay must be a positive finite number");
-	if (delay === 0) return Promise.resolve();
-	return new Promise((resolve) => setTimeout(resolve, delay));
-}
-/**
-* Retries a function until it succeeds or the maximum number of retries is reached
-* @param func The function to retry
-* @param retries The number of retries
-* @param delay The delay between retries (optional)
-* @returns The result of the function
-*/
-async function retry(func, retries, delay = 0) {
-	try {
-		return await func();
-	} catch (error) {
-		if (retries > 0) {
-			await sleep(delay);
-			return retry(func, retries - 1, delay);
-		}
-		throw error;
-	}
-}
-
-//#endregion
-export { retry, sleep, promise_exports as t };

package/dist/types-C7M9sZlw.d.ts

@@ -1,16 +0,0 @@
-//#region src/types.d.ts
-type Dictionary<T = any> = Record<string, T>;
-type AnyFunction<T = any> = (...args: any[]) => T;
-type ClassValue = string | number | bigint | null | boolean | undefined;
-type ClassArray = ClassValue[];
-type ClassRecord = Record<string, any>;
-type ClassNameValue = ClassValue | ClassArray | ClassRecord;
-type AbbreviationSymbols = Dictionary<number> | string[];
-type AbbreviateOptions = {
-  symbols?: AbbreviationSymbols;
-  precision?: number;
-};
-type Predicate = ((val: unknown) => boolean) | ((val: unknown) => val is unknown);
-type NegatePredicate<T> = T extends ((val: unknown) => val is infer U) ? <V>(val: V) => val is Exclude<V, U> : T extends ((val: unknown) => boolean) ? (val: unknown) => boolean : never;
-//#endregion
-export { Dictionary as a, ClassNameValue as i, AbbreviationSymbols as n, NegatePredicate as o, AnyFunction as r, Predicate as s, AbbreviateOptions as t };