@axi-engine/utils 0.1.8 → 0.1.9

package/dist/index.mjs

@@ -1,355 +1,232 @@
-import { v4 } from "uuid";
-
-//#region src/arrays.ts
-/**
-* Generates an array of numbers from 0 to length-1.
-* @param length The desired length of the array.
-* @returns An array of sequential numbers.
-* @example genArray(3); // returns [0, 1, 2]
-*/
+// src/arrays.ts
 function genArray(length) {
-	return Array.from({ length }, (_v, i) => i);
+  return Array.from({ length }, (_v, i) => i);
 }
-/**
-* Creates a new array with its elements shuffled in a random order.
-* This function does not mutate the original array.
-* @template T The type of elements in the array.
-* @param array The array to shuffle.
-* @returns A new, shuffled array.
-*/
 function shuffleArray(array) {
-	const result = [...array];
-	for (let i = result.length - 1; i > 0; i--) {
-		const j = Math.floor(Math.random() * (i + 1));
-		[result[i], result[j]] = [result[j], result[i]];
-	}
-	return result;
+  const result = [...array];
+  for (let i = result.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [result[i], result[j]] = [result[j], result[i]];
+  }
+  return result;
 }
-/**
-* Checks if the first array is a sequential starting subset of the second array.
-* @param arr1 The potential subset array.
-* @param arr2 The array to check against.
-* @returns `true` if arr1 is a sequential start of arr2, otherwise `false`.
-* @example
-* isSequentialStart([1, 2], [1, 2, 3]); // true
-* isSequentialStart([1, 3], [1, 2, 3]); // false
-*/
 function isSequentialStart(arr1, arr2) {
-	if (arr1.length > arr2.length) return false;
-	return arr1.every((element, index) => element === arr2[index]);
+  if (arr1.length > arr2.length) {
+    return false;
+  }
+  return arr1.every((element, index) => element === arr2[index]);
 }
-/**
-* Checks if two arrays contain the same elements, ignoring order.
-* Works for arrays of primitives like strings or numbers.
-* @template T The type of elements in the array.
-* @param arr1 The first array.
-* @param arr2 The second array.
-* @returns `true` if both arrays contain the same elements, otherwise `false`.
-* @example
-* haveSameElements(['a', 'b'], ['b', 'a']); // true
-* haveSameElements([1, 2, 3], [3, 1, 2]); // true
-* haveSameElements(['a', 'b'], ['a', 'c']); // false
-*/
 function haveSameElements(arr1, arr2) {
-	if (!arr1 && !arr2) return true;
-	if (!arr1 || !arr2) return false;
-	if (arr1.length !== arr2.length) return false;
-	const sortedArr1 = [...arr1].sort();
-	const sortedArr2 = [...arr2].sort();
-	return sortedArr1.every((value, index) => value === sortedArr2[index]);
+  if (!arr1 && !arr2) return true;
+  if (!arr1 || !arr2) return false;
+  if (arr1.length !== arr2.length) return false;
+  const sortedArr1 = [...arr1].sort();
+  const sortedArr2 = [...arr2].sort();
+  return sortedArr1.every((value, index) => value === sortedArr2[index]);
 }
-/**
-* Checks if two arrays are strictly equal (same elements in the same order).
-* @template T The type of elements in the array.
-* @param arr1 The first array.
-* @param arr2 The second array.
-* @returns `true` if the arrays are strictly equal, otherwise `false`.
-* @example
-* areArraysEqual(['a', 'b'], ['a', 'b']); // true
-* areArraysEqual(['a', 'b'], ['b', 'a']); // false
-* areArraysEqual([1, 2], [1, 2, 3]);    // false
-*/
 function areArraysEqual(arr1, arr2) {
-	if (!arr1 && !arr2) return true;
-	if (!arr1 || !arr2) return false;
-	if (arr1.length !== arr2.length) return false;
-	return arr1.every((value, index) => value === arr2[index]);
+  if (!arr1 && !arr2) return true;
+  if (!arr1 || !arr2) return false;
+  if (arr1.length !== arr2.length) return false;
+  return arr1.every((value, index) => value === arr2[index]);
 }
-/**
-* Gets the last element of an array.
-* @template T The type of elements in the array.
-* @param array The array to query.
-* @returns The last element of the array, or `undefined` if the array is empty.
-*/
 function last(array) {
-	return array[array.length - 1];
+  return array[array.length - 1];
 }
-/**
-* Creates a duplicate-free version of an array.
-* @template T The type of elements in the array.
-* @param array The array to process.
-* @returns A new array with only unique elements.
-*/
 function unique(array) {
-	return [...new Set(array)];
+  return [...new Set(array)];
 }
-/**
-* Gets a random element from an array.
-* @template T The type of elements in the array.
-* @param array The array to choose from.
-* @returns A random element from the array, or `undefined` if the array is empty.
-*/
 function getRandomElement(array) {
-	if (array.length === 0) return;
-	return array[Math.floor(Math.random() * array.length)];
+  if (array.length === 0) {
+    return void 0;
+  }
+  const index = Math.floor(Math.random() * array.length);
+  return array[index];
 }
 
-//#endregion
-//#region src/guards.ts
+// src/guards.ts
 function isNullOrUndefined(val) {
-	return val === void 0 || val === null;
+  return val === void 0 || val === null;
 }
 function isUndefined(val) {
-	return typeof val === "undefined";
+  return typeof val === "undefined";
 }
 function isNumber(val) {
-	return typeof val === "number";
+  return typeof val === "number";
 }
 function isBoolean(val) {
-	return typeof val === "boolean";
+  return typeof val === "boolean";
 }
 function isString(val) {
-	return typeof val === "string";
+  return typeof val === "string";
 }
-/**
-* Type guard to check if a value is a string that ends with '%'.
-* @param val The value to check.
-* @returns `true` if the value is a percentage string.
-*/
 function isPercentageString(val) {
-	return typeof val === "string" && val.endsWith("%");
+  return typeof val === "string" && val.endsWith("%");
 }
 
-//#endregion
-//#region src/assertion.ts
-/**
-* Throws an error if the condition is true.
-* @param conditionForThrow - If true, an error will be thrown.
-* @param exceptionMessage - The message for the error.
-* @throws {Error} if the value is true
-*/
+// src/assertion.ts
 function throwIf(conditionForThrow, exceptionMessage) {
-	if (conditionForThrow) throw new Error(exceptionMessage);
+  if (conditionForThrow) {
+    throw new Error(exceptionMessage);
+  }
 }
-/**
-* Throws an error if the value is null, undefined, or an empty array.
-*
-* @template T The type of the value being checked.
-* @param value The value to check.
-* @param exceptionMessage The message for the error.
-* @throws {Error} if the value is null, undefined, or an empty array.
-*
-* @example
-* // Example with a potentially undefined variable
-* const user: { name: string } | undefined = findUser();
-* throwIfEmpty(user, 'User not found');
-* // From here, TypeScript knows `user` is not undefined.
-* console.log(user.name);
-*
-* @example
-* // Example with an array
-* const items: string[] = getItems();
-* throwIfEmpty(items, 'Items array cannot be empty');
-* // From here, you can safely access items[0] without checking for an empty array again.
-* console.log('First item:', items[0]);
-*/
 function throwIfEmpty(value, exceptionMessage) {
-	const isArrayAndEmpty = Array.isArray(value) && value.length === 0;
-	if (isNullOrUndefined(value) || isArrayAndEmpty) throw new Error(exceptionMessage);
+  const isArrayAndEmpty = Array.isArray(value) && value.length === 0;
+  if (isNullOrUndefined(value) || isArrayAndEmpty) {
+    throw new Error(exceptionMessage);
+  }
 }
 
-//#endregion
-//#region src/config.ts
-const defaultConfig = { pathSeparator: "/" };
-const axiSettings = { ...defaultConfig };
-/**
-* set up global configuration for axi-engine.
-* @param newConfig - configuration object
-*/
+// src/config.ts
+var defaultConfig = {
+  pathSeparator: "/"
+};
+var axiSettings = { ...defaultConfig };
 function configure(newConfig) {
-	Object.assign(axiSettings, newConfig);
+  Object.assign(axiSettings, newConfig);
 }
 
-//#endregion
-//#region src/constructor-registry.ts
-/**
-* A generic registry for mapping string identifiers to class constructors.
-*
-* This utility is fundamental for building extensible systems like dependency injection containers,
-* factories, and serialization engines where types need to be dynamically resolved.
-*
-* @template T - A base type that all registered constructors must produce an instance of.
-*/
+// src/constructor-registry.ts
 var ConstructorRegistry = class {
-	items = /* @__PURE__ */ new Map();
-	/**
-	* Registers a constructor with a unique string identifier.
-	*
-	* @param typeId - The unique identifier for the constructor (e.g., a static `typeName` property from a class).
-	* @param ctor - The class constructor to register.
-	* @returns The registry instance for chainable calls.
-	* @throws If a constructor with the same `typeId` is already registered.
-	*/
-	register(typeId, ctor) {
-		throwIf(this.items.has(typeId), `A constructor with typeId '${typeId}' is already registered.`);
-		this.items.set(typeId, ctor);
-		return this;
-	}
-	/**
-	* Retrieves a constructor by its identifier.
-	*
-	* @param typeId - The identifier of the constructor to retrieve.
-	* @returns The found class constructor.
-	* @throws If no constructor is found for the given `typeId`.
-	*/
-	get(typeId) {
-		const Ctor = this.items.get(typeId);
-		throwIfEmpty(Ctor, `No constructor found for typeId '${typeId}'`);
-		return Ctor;
-	}
-	/**
-	* Checks if a constructor for a given identifier is registered.
-	* @param typeId - The identifier to check.
-	* @returns `true` if a constructor is registered, otherwise `false`.
-	*/
-	has(typeId) {
-		return this.items.has(typeId);
-	}
-	/**
-	* Clears all registered constructors from the registry.
-	*/
-	clear() {
-		this.items.clear();
-	}
+  items = /* @__PURE__ */ new Map();
+  /**
+   * Registers a constructor with a unique string identifier.
+   *
+   * @param typeId - The unique identifier for the constructor (e.g., a static `typeName` property from a class).
+   * @param ctor - The class constructor to register.
+   * @returns The registry instance for chainable calls.
+   * @throws If a constructor with the same `typeId` is already registered.
+   */
+  register(typeId, ctor) {
+    throwIf(this.items.has(typeId), `A constructor with typeId '${typeId}' is already registered.`);
+    this.items.set(typeId, ctor);
+    return this;
+  }
+  /**
+   * Retrieves a constructor by its identifier.
+   *
+   * @param typeId - The identifier of the constructor to retrieve.
+   * @returns The found class constructor.
+   * @throws If no constructor is found for the given `typeId`.
+   */
+  get(typeId) {
+    const Ctor = this.items.get(typeId);
+    throwIfEmpty(Ctor, `No constructor found for typeId '${typeId}'`);
+    return Ctor;
+  }
+  /**
+   * Checks if a constructor for a given identifier is registered.
+   * @param typeId - The identifier to check.
+   * @returns `true` if a constructor is registered, otherwise `false`.
+   */
+  has(typeId) {
+    return this.items.has(typeId);
+  }
+  /**
+   * Clears all registered constructors from the registry.
+   */
+  clear() {
+    this.items.clear();
+  }
 };
 
-//#endregion
-//#region src/emitter.ts
-/**
-* A minimal, type-safe event emitter for a single event.
-* It does not manage state, it only manages subscribers and event dispatching.
-* @template T A tuple representing the types of the event arguments.
-*/
+// src/emitter.ts
 var Emitter = class {
-	listeners = /* @__PURE__ */ new Set();
-	/**
-	* Returns the number of listeners.
-	*/
-	get listenerCount() {
-		return this.listeners.size;
-	}
-	/**
-	* Subscribes a listener to this event.
-	* @returns A function to unsubscribe the listener.
-	*/
-	subscribe(listener) {
-		this.listeners.add(listener);
-		return () => this.listeners.delete(listener);
-	}
-	/**
-	* Manually unsubscribe by listener
-	* @returns returns true if an listener has been removed, or false if the listener does not exist.
-	*/
-	unsubscribe(listener) {
-		return this.listeners.delete(listener);
-	}
-	/**
-	* Dispatches the event to all subscribed listeners.
-	*/
-	emit(...args) {
-		this.listeners.forEach((listener) => listener(...args));
-	}
-	/**
-	* Clears all listeners.
-	*/
-	clear() {
-		this.listeners.clear();
-	}
+  listeners = /* @__PURE__ */ new Set();
+  /**
+   * Returns the number of listeners.
+   */
+  get listenerCount() {
+    return this.listeners.size;
+  }
+  /**
+   * Subscribes a listener to this event.
+   * @returns A function to unsubscribe the listener.
+   */
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  /**
+   * Manually unsubscribe by listener
+   * @returns returns true if an listener has been removed, or false if the listener does not exist.
+   */
+  unsubscribe(listener) {
+    return this.listeners.delete(listener);
+  }
+  /**
+   * Dispatches the event to all subscribed listeners.
+   */
+  emit(...args) {
+    this.listeners.forEach((listener) => listener(...args));
+  }
+  /**
+   * Clears all listeners.
+   */
+  clear() {
+    this.listeners.clear();
+  }
 };
 
-//#endregion
-//#region src/math.ts
-/**
-* Clamps a number between an optional minimum and maximum value.
-* @param val The number to clamp.
-* @param min The minimum value. If null or undefined, it's ignored.
-* @param max The maximum value. If null or undefined, it's ignored.
-* @returns The clamped number.
-*/
+// src/math.ts
 function clampNumber(val, min, max) {
-	if (!isNullOrUndefined(min)) val = Math.max(val, min);
-	if (!isNullOrUndefined(max)) val = Math.min(val, max);
-	return val;
+  if (!isNullOrUndefined(min)) val = Math.max(val, min);
+  if (!isNullOrUndefined(max)) val = Math.min(val, max);
+  return val;
 }
-/**
-* Calculates a percentage of a given value.
-* @param val The base value.
-* @param percents The percentage to get.
-* @returns The calculated percentage of the value.
-* @example getPercentOf(200, 10); // returns 20
-*/
 function getPercentOf(val, percents) {
-	return percents / 100 * val;
+  return percents / 100 * val;
 }
 
-//#endregion
-//#region src/misc.ts
-/**
-* Returns the first key of an object.
-* @param obj The object from which to get the key.
-* @returns The first key of the object as a string.
-*/
+// src/misc.ts
 function firstKeyOf(obj) {
-	return Object.keys(obj)[0];
+  return Object.keys(obj)[0];
 }
 
-//#endregion
-//#region src/path.ts
-/**
-* Ensures that the given path is returned as an array of segments.
-*/
+// src/path.ts
 function ensurePathArray(path, separator = axiSettings.pathSeparator) {
-	return Array.isArray(path) ? [...path] : path.split(separator);
+  return Array.isArray(path) ? [...path] : path.split(separator);
 }
-/**
-* Ensures that the given path is returned as a single string.
-*/
 function ensurePathString(path, separator = axiSettings.pathSeparator) {
-	return !Array.isArray(path) ? path : path.join(separator);
+  return !Array.isArray(path) ? path : path.join(separator);
 }
 
-//#endregion
-//#region src/random.ts
-/**
-* Returns a random integer between min (inclusive) and max (exclusive).
-* @param min The minimum integer (inclusive).
-* @param max The maximum integer (exclusive).
-* @returns A random integer.
-* @example randInt(1, 5); // returns 1, 2, 3, or 4
-*/
+// src/random.ts
+import { v4 as uuidv4 } from "uuid";
 function randInt(min, max) {
-	min = Math.ceil(min);
-	max = Math.floor(max);
-	return Math.floor(Math.random() * (max - min) + min);
+  min = Math.ceil(min);
+  max = Math.floor(max);
+  return Math.floor(Math.random() * (max - min) + min);
 }
-/**
-* Generates a unique identifier using uuidv4.
-* @returns A unique string ID.
-*/
 function randId() {
-	return v4();
-}
-
-//#endregion
-export { ConstructorRegistry, Emitter, areArraysEqual, axiSettings, clampNumber, configure, ensurePathArray, ensurePathString, firstKeyOf, genArray, getPercentOf, getRandomElement, haveSameElements, isBoolean, isNullOrUndefined, isNumber, isPercentageString, isSequentialStart, isString, isUndefined, last, randId, randInt, shuffleArray, throwIf, throwIfEmpty, unique };
-//# sourceMappingURL=index.mjs.map
+  return uuidv4();
+}
+export {
+  ConstructorRegistry,
+  Emitter,
+  areArraysEqual,
+  axiSettings,
+  clampNumber,
+  configure,
+  ensurePathArray,
+  ensurePathString,
+  firstKeyOf,
+  genArray,
+  getPercentOf,
+  getRandomElement,
+  haveSameElements,
+  isBoolean,
+  isNullOrUndefined,
+  isNumber,
+  isPercentageString,
+  isSequentialStart,
+  isString,
+  isUndefined,
+  last,
+  randId,
+  randInt,
+  shuffleArray,
+  throwIf,
+  throwIfEmpty,
+  unique
+};

package/dist/math.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Clamps a number between an optional minimum and maximum value.
+ * @param val The number to clamp.
+ * @param min The minimum value. If null or undefined, it's ignored.
+ * @param max The maximum value. If null or undefined, it's ignored.
+ * @returns The clamped number.
+ */
+export declare function clampNumber(val: number, min?: number | null, max?: number | null): number;
+/**
+ * Calculates a percentage of a given value.
+ * @param val The base value.
+ * @param percents The percentage to get.
+ * @returns The calculated percentage of the value.
+ * @example getPercentOf(200, 10); // returns 20
+ */
+export declare function getPercentOf(val: number, percents: number): number;
+//# sourceMappingURL=math.d.ts.map

package/dist/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../src/math.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAIzF;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAEzD"}

package/dist/math.js

@@ -0,0 +1,26 @@
+import { isNullOrUndefined } from './guards';
+/**
+ * Clamps a number between an optional minimum and maximum value.
+ * @param val The number to clamp.
+ * @param min The minimum value. If null or undefined, it's ignored.
+ * @param max The maximum value. If null or undefined, it's ignored.
+ * @returns The clamped number.
+ */
+export function clampNumber(val, min, max) {
+    if (!isNullOrUndefined(min))
+        val = Math.max(val, min);
+    if (!isNullOrUndefined(max))
+        val = Math.min(val, max);
+    return val;
+}
+/**
+ * Calculates a percentage of a given value.
+ * @param val The base value.
+ * @param percents The percentage to get.
+ * @returns The calculated percentage of the value.
+ * @example getPercentOf(200, 10); // returns 20
+ */
+export function getPercentOf(val, percents) {
+    return (percents / 100) * val;
+}
+//# sourceMappingURL=math.js.map

package/dist/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../src/math.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAC,MAAM,UAAU,CAAC;AAG3C;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,GAAmB,EAAE,GAAmB;IAC/E,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACtD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,QAAgB;IACxD,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAChC,CAAC"}

package/dist/misc.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Returns the first key of an object.
+ * @param obj The object from which to get the key.
+ * @returns The first key of the object as a string.
+ */
+export declare function firstKeyOf(obj: any): string;
+//# sourceMappingURL=misc.d.ts.map

package/dist/misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../src/misc.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,UAElC"}

package/dist/misc.js

@@ -0,0 +1,9 @@
+/**
+ * Returns the first key of an object.
+ * @param obj The object from which to get the key.
+ * @returns The first key of the object as a string.
+ */
+export function firstKeyOf(obj) {
+    return Object.keys(obj)[0];
+}
+//# sourceMappingURL=misc.js.map

package/dist/misc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../src/misc.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,GAAQ;IACjC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/path.d.ts

@@ -0,0 +1,10 @@
+import { PathType } from "./types";
+/**
+ * Ensures that the given path is returned as an array of segments.
+ */
+export declare function ensurePathArray(path: PathType, separator?: string): string[];
+/**
+ * Ensures that the given path is returned as a single string.
+ */
+export declare function ensurePathString(path: PathType, separator?: string): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,SAAS,CAAC;AAGjC;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,SAA4B,GAAG,MAAM,EAAE,CAE/F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,SAA4B,GAAG,MAAM,CAE9F"}

package/dist/path.js

@@ -0,0 +1,14 @@
+import { axiSettings } from './config';
+/**
+ * Ensures that the given path is returned as an array of segments.
+ */
+export function ensurePathArray(path, separator = axiSettings.pathSeparator) {
+    return Array.isArray(path) ? [...path] : path.split(separator);
+}
+/**
+ * Ensures that the given path is returned as a single string.
+ */
+export function ensurePathString(path, separator = axiSettings.pathSeparator) {
+    return !Array.isArray(path) ? path : path.join(separator);
+}
+//# sourceMappingURL=path.js.map

package/dist/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAC,MAAM,UAAU,CAAC;AAErC;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAc,EAAE,SAAS,GAAG,WAAW,CAAC,aAAa;IACnF,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAc,EAAE,SAAS,GAAG,WAAW,CAAC,aAAa;IACpF,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC5D,CAAC"}

package/dist/random.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Returns a random integer between min (inclusive) and max (exclusive).
+ * @param min The minimum integer (inclusive).
+ * @param max The maximum integer (exclusive).
+ * @returns A random integer.
+ * @example randInt(1, 5); // returns 1, 2, 3, or 4
+ */
+export declare function randInt(min: number, max: number): number;
+/**
+ * Generates a unique identifier using uuidv4.
+ * @returns A unique string ID.
+ */
+export declare function randId(): string;
+//# sourceMappingURL=random.d.ts.map

package/dist/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../src/random.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED;;;GAGG;AACH,wBAAgB,MAAM,WAErB"}