@alextheman/utility 2.5.0 → 2.7.0

package/dist/index.cjs

@@ -66,6 +66,7 @@ __export(index_exports, {
   randomiseArray: () => randomiseArray_default,
   range: () => range_default,
   removeDuplicates: () => removeDuplicates_default,
+  stringListToArray: () => stringListToArray_default,
   stringToBoolean: () => stringToBoolean_default,
   truncate: () => truncate_default,
   wait: () => wait_default
@@ -157,21 +158,42 @@ function formatDateAndTime(inputDate) {
 }
 var formatDateAndTime_default = formatDateAndTime;
 
+// src/functions/parseIntStrict.ts
+var IntegerParsingError = new TypeError("INTEGER_PARSING_ERROR");
+function parseIntStrict(...[string, radix]) {
+  const trimmedString = string.trim();
+  const pattern = radix && radix > 10 && radix <= 36 ? (
+    // String.fromCharCode() gets the maximum possible alphabetical character for a base above 10
+    new RegExp(`^[+-]?[0-9a-${String.fromCharCode(87 + radix - 1)}]+$`, "i")
+  ) : /^[+-]?\d+$/;
+  if (!pattern.test(trimmedString)) {
+    throw IntegerParsingError;
+  }
+  if (radix && radix < 10 && [...trimmedString].some((character) => {
+    return parseInt(character) >= radix;
+  })) {
+    throw IntegerParsingError;
+  }
+  const parseIntResult = parseInt(trimmedString, radix);
+  if (isNaN(parseIntResult)) {
+    throw IntegerParsingError;
+  }
+  return parseIntResult;
+}
+var parseIntStrict_default = parseIntStrict;
+
 // src/functions/getRandomNumber.ts
 function getRandomNumber(lowerBound, upperBound) {
-  if (lowerBound % 1 !== 0 || upperBound % 1 !== 0) {
-    throw new TypeError("NON_INTEGER_INPUTS");
-  }
-  return Math.floor(Math.random() * (upperBound - lowerBound + 1) + lowerBound);
+  const parsedLowerBound = parseIntStrict_default(`${lowerBound}`);
+  const parsedUpperBound = parseIntStrict_default(`${upperBound}`);
+  return Math.floor(Math.random() * (parsedUpperBound - parsedLowerBound + 1) + parsedLowerBound);
 }
 var getRandomNumber_default = getRandomNumber;
 
 // src/functions/isLeapYear.ts
 function isLeapYear(year) {
-  if (year % 1 !== 0) {
-    throw new TypeError("NON_INTEGER_INPUT");
-  }
-  return year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;
+  const parsedYear = parseIntStrict_default(`${year}`);
+  return parsedYear % 4 === 0 && parsedYear % 100 !== 0 || parsedYear % 400 === 0;
 }
 var isLeapYear_default = isLeapYear;
 
@@ -223,30 +245,6 @@ function omitProperties(object, keysToOmit) {
 }
 var omitProperties_default = omitProperties;
 
-// src/functions/parseIntStrict.ts
-var IntegerParsingError = new TypeError("INTEGER_PARSING_ERROR");
-function parseIntStrict(string, radix) {
-  const trimmedString = string.trim();
-  const pattern = radix && radix > 10 && radix <= 36 ? (
-    // String.fromCharCode() gets the maximum possible alphabetical character for a base above 10
-    new RegExp(`^[+-]?[0-9a-${String.fromCharCode(87 + radix - 1)}]+$`, "i")
-  ) : /^[+-]?\d+$/;
-  if (!pattern.test(trimmedString)) {
-    throw IntegerParsingError;
-  }
-  if (radix && radix < 10 && [...trimmedString].some((character) => {
-    return parseInt(character) >= radix;
-  })) {
-    throw IntegerParsingError;
-  }
-  const parseIntResult = parseInt(trimmedString, radix);
-  if (isNaN(parseIntResult)) {
-    throw IntegerParsingError;
-  }
-  return parseIntResult;
-}
-var parseIntStrict_default = parseIntStrict;
-
 // src/functions/randomiseArray.ts
 function randomiseArray(array) {
   const mutableArray = [...array];
@@ -295,6 +293,18 @@ function removeDuplicates(array) {
 }
 var removeDuplicates_default = removeDuplicates;
 
+// src/functions/stringListToArray.ts
+function stringListToArray(stringList, { separator = ",", trimWhitespace = true } = {}) {
+  if (trimWhitespace && stringList.trim() === "") {
+    return [];
+  }
+  const arrayList = stringList.split(separator != null ? separator : "");
+  return trimWhitespace ? arrayList.map((item) => {
+    return item.trim();
+  }) : arrayList;
+}
+var stringListToArray_default = stringListToArray;
+
 // src/functions/stringToBoolean.ts
 function stringToBoolean(inputString) {
   const normalisedString = inputString.toLowerCase();
@@ -412,6 +422,7 @@ var UUID_default = parseUUID;
   randomiseArray,
   range,
   removeDuplicates,
+  stringListToArray,
   stringToBoolean,
   truncate,
   wait

package/dist/index.d.cts

@@ -22,7 +22,7 @@ declare function isSameDate(firstDate: Date, secondDate: Date): boolean;
 
 declare function omitProperties<T extends Record<string, unknown> | Readonly<Record<string, unknown>>, K extends keyof T>(object: T, keysToOmit: K | readonly K[]): Omit<T, K>;
 
-declare function parseIntStrict(string: string, radix?: number): number;
+declare function parseIntStrict(...[string, radix]: Parameters<typeof parseInt>): number;
 
 declare function randomiseArray<T>(array: T[]): T[];
 
@@ -30,6 +30,12 @@ declare function range(start: number, stop: number, step?: number): number[];
 
 declare function removeDuplicates<T>(array: T[] | readonly T[]): T[];
 
+interface StringListToArrayOptions {
+    separator?: string;
+    trimWhitespace?: boolean;
+}
+declare function stringListToArray(stringList: string, { separator, trimWhitespace }?: StringListToArrayOptions): string[];
+
 declare function stringToBoolean(inputString: string): boolean;
 
 declare function truncate(stringToTruncate: string, maxLength?: number): string;
@@ -68,4 +74,4 @@ type DisallowUndefined<T> = undefined extends T ? ["Error: Generic type cannot i
 
 type NonUndefined<T> = T extends undefined ? never : T;
 
-export { APIError, type DisallowUndefined, type Email, type Env, type HTTPErrorCode, type HTTPErrorCodes, type NonUndefined, type UUID, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, fillArray, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isSameDate, omitProperties, parseEmail, parseEnv, parseIntStrict, parseUUID, randomiseArray, range, removeDuplicates, stringToBoolean, truncate, wait };
+export { APIError, type DisallowUndefined, type Email, type Env, type HTTPErrorCode, type HTTPErrorCodes, type NonUndefined, type UUID, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, fillArray, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isSameDate, omitProperties, parseEmail, parseEnv, parseIntStrict, parseUUID, randomiseArray, range, removeDuplicates, stringListToArray, stringToBoolean, truncate, wait };

package/dist/index.d.ts

@@ -22,7 +22,7 @@ declare function isSameDate(firstDate: Date, secondDate: Date): boolean;
 
 declare function omitProperties<T extends Record<string, unknown> | Readonly<Record<string, unknown>>, K extends keyof T>(object: T, keysToOmit: K | readonly K[]): Omit<T, K>;
 
-declare function parseIntStrict(string: string, radix?: number): number;
+declare function parseIntStrict(...[string, radix]: Parameters<typeof parseInt>): number;
 
 declare function randomiseArray<T>(array: T[]): T[];
 
@@ -30,6 +30,12 @@ declare function range(start: number, stop: number, step?: number): number[];
 
 declare function removeDuplicates<T>(array: T[] | readonly T[]): T[];
 
+interface StringListToArrayOptions {
+    separator?: string;
+    trimWhitespace?: boolean;
+}
+declare function stringListToArray(stringList: string, { separator, trimWhitespace }?: StringListToArrayOptions): string[];
+
 declare function stringToBoolean(inputString: string): boolean;
 
 declare function truncate(stringToTruncate: string, maxLength?: number): string;
@@ -68,4 +74,4 @@ type DisallowUndefined<T> = undefined extends T ? ["Error: Generic type cannot i
 
 type NonUndefined<T> = T extends undefined ? never : T;
 
-export { APIError, type DisallowUndefined, type Email, type Env, type HTTPErrorCode, type HTTPErrorCodes, type NonUndefined, type UUID, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, fillArray, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isSameDate, omitProperties, parseEmail, parseEnv, parseIntStrict, parseUUID, randomiseArray, range, removeDuplicates, stringToBoolean, truncate, wait };
+export { APIError, type DisallowUndefined, type Email, type Env, type HTTPErrorCode, type HTTPErrorCodes, type NonUndefined, type UUID, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, fillArray, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isSameDate, omitProperties, parseEmail, parseEnv, parseIntStrict, parseUUID, randomiseArray, range, removeDuplicates, stringListToArray, stringToBoolean, truncate, wait };

package/dist/index.js

@@ -101,21 +101,42 @@ function formatDateAndTime(inputDate) {
 }
 var formatDateAndTime_default = formatDateAndTime;
 
+// src/functions/parseIntStrict.ts
+var IntegerParsingError = new TypeError("INTEGER_PARSING_ERROR");
+function parseIntStrict(...[string, radix]) {
+  const trimmedString = string.trim();
+  const pattern = radix && radix > 10 && radix <= 36 ? (
+    // String.fromCharCode() gets the maximum possible alphabetical character for a base above 10
+    new RegExp(`^[+-]?[0-9a-${String.fromCharCode(87 + radix - 1)}]+$`, "i")
+  ) : /^[+-]?\d+$/;
+  if (!pattern.test(trimmedString)) {
+    throw IntegerParsingError;
+  }
+  if (radix && radix < 10 && [...trimmedString].some((character) => {
+    return parseInt(character) >= radix;
+  })) {
+    throw IntegerParsingError;
+  }
+  const parseIntResult = parseInt(trimmedString, radix);
+  if (isNaN(parseIntResult)) {
+    throw IntegerParsingError;
+  }
+  return parseIntResult;
+}
+var parseIntStrict_default = parseIntStrict;
+
 // src/functions/getRandomNumber.ts
 function getRandomNumber(lowerBound, upperBound) {
-  if (lowerBound % 1 !== 0 || upperBound % 1 !== 0) {
-    throw new TypeError("NON_INTEGER_INPUTS");
-  }
-  return Math.floor(Math.random() * (upperBound - lowerBound + 1) + lowerBound);
+  const parsedLowerBound = parseIntStrict_default(`${lowerBound}`);
+  const parsedUpperBound = parseIntStrict_default(`${upperBound}`);
+  return Math.floor(Math.random() * (parsedUpperBound - parsedLowerBound + 1) + parsedLowerBound);
 }
 var getRandomNumber_default = getRandomNumber;
 
 // src/functions/isLeapYear.ts
 function isLeapYear(year) {
-  if (year % 1 !== 0) {
-    throw new TypeError("NON_INTEGER_INPUT");
-  }
-  return year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;
+  const parsedYear = parseIntStrict_default(`${year}`);
+  return parsedYear % 4 === 0 && parsedYear % 100 !== 0 || parsedYear % 400 === 0;
 }
 var isLeapYear_default = isLeapYear;
 
@@ -167,30 +188,6 @@ function omitProperties(object, keysToOmit) {
 }
 var omitProperties_default = omitProperties;
 
-// src/functions/parseIntStrict.ts
-var IntegerParsingError = new TypeError("INTEGER_PARSING_ERROR");
-function parseIntStrict(string, radix) {
-  const trimmedString = string.trim();
-  const pattern = radix && radix > 10 && radix <= 36 ? (
-    // String.fromCharCode() gets the maximum possible alphabetical character for a base above 10
-    new RegExp(`^[+-]?[0-9a-${String.fromCharCode(87 + radix - 1)}]+$`, "i")
-  ) : /^[+-]?\d+$/;
-  if (!pattern.test(trimmedString)) {
-    throw IntegerParsingError;
-  }
-  if (radix && radix < 10 && [...trimmedString].some((character) => {
-    return parseInt(character) >= radix;
-  })) {
-    throw IntegerParsingError;
-  }
-  const parseIntResult = parseInt(trimmedString, radix);
-  if (isNaN(parseIntResult)) {
-    throw IntegerParsingError;
-  }
-  return parseIntResult;
-}
-var parseIntStrict_default = parseIntStrict;
-
 // src/functions/randomiseArray.ts
 function randomiseArray(array) {
   const mutableArray = [...array];
@@ -239,6 +236,18 @@ function removeDuplicates(array) {
 }
 var removeDuplicates_default = removeDuplicates;
 
+// src/functions/stringListToArray.ts
+function stringListToArray(stringList, { separator = ",", trimWhitespace = true } = {}) {
+  if (trimWhitespace && stringList.trim() === "") {
+    return [];
+  }
+  const arrayList = stringList.split(separator != null ? separator : "");
+  return trimWhitespace ? arrayList.map((item) => {
+    return item.trim();
+  }) : arrayList;
+}
+var stringListToArray_default = stringListToArray;
+
 // src/functions/stringToBoolean.ts
 function stringToBoolean(inputString) {
   const normalisedString = inputString.toLowerCase();
@@ -355,6 +364,7 @@ export {
   randomiseArray_default as randomiseArray,
   range_default as range,
   removeDuplicates_default as removeDuplicates,
+  stringListToArray_default as stringListToArray,
   stringToBoolean_default as stringToBoolean,
   truncate_default as truncate,
   wait_default as wait

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/utility",
-  "version": "2.5.0",
+  "version": "2.7.0",
   "description": "Helpful utility functions",
   "license": "ISC",
   "author": "alextheman",
@@ -36,20 +36,20 @@
     "zod": "^4.1.12"
   },
   "devDependencies": {
-    "@alextheman/eslint-plugin": "^2.2.1",
-    "@eslint/js": "^9.38.0",
-    "@types/node": "^24.9.1",
-    "eslint": "^9.38.0",
+    "@alextheman/eslint-plugin": "^2.4.1",
+    "@eslint/js": "^9.39.0",
+    "@types/node": "^24.9.2",
+    "eslint": "^9.39.0",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
     "globals": "^16.4.0",
     "husky": "^9.1.7",
-    "jsdom": "^27.0.1",
+    "jsdom": "^27.1.0",
     "prettier": "^3.6.2",
     "tsup": "^8.5.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.46.2",
     "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^4.0.3"
+    "vitest": "^4.0.6"
   }
 }