complete-common 2.29.0 → 2.31.0

package/dist/index.cjs

@@ -102,7 +102,7 @@ function assertEnumValue(value, transpiledEnum, msg, set) {
   }
 }
 function assertInteger(value, msg) {
-  if (!Number.isInteger(value)) {
+  if (!Number.isSafeInteger(value)) {
     throw new TypeError(msg);
   }
 }
@@ -126,6 +126,11 @@ function assertObject(value, ...[msg]) {
     throw new TypeError(msg);
   }
 }
+function assertPositiveInteger(value, msg) {
+  if (!Number.isSafeInteger(value) || value <= 0) {
+    throw new TypeError(msg);
+  }
+}
 function assertString(value, ...[msg]) {
   if (typeof value !== "string") {
     throw new TypeError(msg);
@@ -156,11 +161,7 @@ function getRandomInt(min, max, exceptions = []) {
 }
 
 function arrayCopyTwoDimensional(array) {
-  const copiedArray = [];
-  for (const subArray of array) {
-    copiedArray.push([...subArray]);
-  }
-  return copiedArray;
+  return Array.from(array, (subArray) => [...subArray]);
 }
 function arrayEquals(array1, array2) {
   if (array1.length !== array2.length) {
@@ -207,7 +208,7 @@ function arrayRemoveInPlace(array, ...elementsToRemove) {
   return removedElements;
 }
 function emptyArray(array) {
-  array.splice(0);
+  array.length = 0;
 }
 async function filterAsync(array, predicate) {
   const results = await Promise.all(
@@ -394,11 +395,7 @@ function combineSets(...sets) {
   return newSet;
 }
 function copySet(oldSet) {
-  const newSet = /* @__PURE__ */ new Set();
-  for (const value of oldSet) {
-    newSet.add(value);
-  }
-  return newSet;
+  return new Set(oldSet);
 }
 function objectKeysToSet(object) {
   const set = /* @__PURE__ */ new Set();
@@ -426,15 +423,13 @@ function setHas(set, ...elements) {
 function sortCaseInsensitive(array) {
   const newArray = [...array];
   newArray.sort(
-    (a, b) => a.localeCompare(b, void 0, {
-      sensitivity: "base"
-    })
+    (a, b) => a.localeCompare(b, void 0, { sensitivity: "base" })
   );
   return newArray;
 }
 
-const FLOAT_REGEX = /^-?\d*\.?\d+$/;
-const INTEGER_REGEX = /^-?\d+$/;
+const FLOAT_REGEX = /^-?(?:\d+(?:\.\d+)?|\.\d+)$/v;
+const INTEGER_REGEX = /^-?\d+$/v;
 function* eRange(start, end, increment = 1) {
   if (end === void 0) {
     yield* eRange(0, start, increment);
@@ -453,7 +448,7 @@ function* iRange(start, end, increment = 1) {
   yield* eRange(start, exclusiveEnd, increment);
 }
 function isKeyOf(key, target) {
-  return key in target;
+  return Object.hasOwn(target, key);
 }
 function noop() {
 }
@@ -462,10 +457,10 @@ function parseFloatSafe(string) {
     return void 0;
   }
   const trimmedString = string.trim();
-  if (FLOAT_REGEX.exec(trimmedString) === null) {
+  if (!FLOAT_REGEX.test(trimmedString)) {
     return void 0;
   }
-  const number = Number.parseFloat(trimmedString);
+  const number = Number(trimmedString);
   return Number.isNaN(number) ? void 0 : number;
 }
 function parseIntSafe(string) {
@@ -473,10 +468,10 @@ function parseIntSafe(string) {
     return void 0;
   }
   const trimmedString = string.trim();
-  if (INTEGER_REGEX.exec(trimmedString) === null) {
+  if (!INTEGER_REGEX.test(trimmedString)) {
     return void 0;
   }
-  const number = Number.parseInt(trimmedString, 10);
+  const number = Math.trunc(Number(trimmedString));
   return Number.isNaN(number) ? void 0 : number;
 }
 function repeat(num, func) {
@@ -487,17 +482,17 @@ function repeat(num, func) {
 function todo(...args) {
 }
 
-const ASCII_REGEX = /^[\u0000-\u007F]*$/;
-const DIACRITIC_REGEX = /\p{Diacritic}/u;
-const EMOJI_REGEX = /(\p{Extended_Pictographic}|[#*0-9]\uFE0F?\u20E3)/u;
-const FIRST_LETTER_CAPITALIZED_REGEX = /^\p{Lu}/u;
-const KEBAB_CASE_REGEX = /^[\da-z]+(?:-[\da-z]+)*$/;
-const SEMANTIC_VERSION_REGEX = /^v*(?<major>\d+)\.(?<minor>\d+)\.(?<patch>\d+)/;
-const WHITESPACE_REGEX = /\s/;
-const WHITESPACE_GLOBAL_REGEX = /\s/g;
-const TITLE_CASE_BOUNDARY_REGEX = /(?<=[\da-z])(?=[A-Z])/g;
-const UPPERCASE_REGEX = /^[A-Z]*$/;
-const LOWERCASE_REGEX = /^[a-z]*$/;
+const ASCII_REGEX = /^\p{ASCII}*$/v;
+const DIACRITIC_REGEX = /\p{Diacritic}/v;
+const FIRST_LETTER_CAPITALIZED_REGEX = /^\p{Lu}/v;
+const EMOJI_REGEX = /\p{Extended_Pictographic}|[#*0-9]\u{FE0F}?\u{20E3}/v;
+const KEBAB_CASE_REGEX = /^[\da-z]+(?:-[\da-z]+)*$/v;
+const SEMANTIC_VERSION_REGEX = /^v*(?<major>\d+)\.(?<minor>\d+)\.(?<patch>\d+)/v;
+const WHITESPACE_REGEX = /\s/v;
+const WHITESPACE_GLOBAL_REGEX = /\s/gv;
+const TITLE_CASE_BOUNDARY_REGEX = /(?<=[\da-z])(?=[A-Z])/gv;
+const UPPERCASE_REGEX = /^[A-Z]*$/v;
+const LOWERCASE_REGEX = /^[a-z]*$/v;
 function capitalizeFirstLetter(string) {
   if (string === "") {
     return string;
@@ -555,8 +550,8 @@ function isUpperCase(string) {
   return UPPERCASE_REGEX.test(string);
 }
 function kebabCaseToCamelCase(string) {
-  return string.replaceAll(/-./g, (match) => {
-    const firstLetterOfWord = match[1];
+  return string.replaceAll(/-./gv, (match) => {
+    const firstLetterOfWord = match.at(1);
     return firstLetterOfWord === void 0 ? "" : firstLetterOfWord.toUpperCase();
   });
 }
@@ -568,14 +563,14 @@ function normalizeString(string) {
   let sanitizedString = string;
   sanitizedString = removeNonPrintableCharacters(sanitizedString);
   sanitizedString = sanitizedString.replaceAll("\n\r", "\n");
-  sanitizedString = sanitizedString.replaceAll(/\p{Zl}/gu, "\n");
-  sanitizedString = sanitizedString.replaceAll(/\p{Zp}/gu, "\n");
-  sanitizedString = sanitizedString.replaceAll(/\p{Zs}/gu, " ");
+  sanitizedString = sanitizedString.replaceAll(/\p{Zl}/gv, "\n");
+  sanitizedString = sanitizedString.replaceAll(/\p{Zp}/gv, "\n");
+  sanitizedString = sanitizedString.replaceAll(/\p{Zs}/gv, " ");
   sanitizedString = sanitizedString.trim();
   return sanitizedString;
 }
 function parseSemanticVersion(versionString) {
-  const match = versionString.match(SEMANTIC_VERSION_REGEX);
+  const match = SEMANTIC_VERSION_REGEX.exec(versionString);
   if (match === null || match.groups === void 0) {
     return void 0;
   }
@@ -589,7 +584,11 @@ function parseSemanticVersion(versionString) {
   if (majorVersion === void 0 || minorVersion === void 0 || patchVersion === void 0) {
     return void 0;
   }
-  return { majorVersion, minorVersion, patchVersion };
+  return {
+    majorVersion,
+    minorVersion,
+    patchVersion
+  };
 }
 function removeLinesBetweenMarkers(string, marker) {
   const lines = string.split("\n");
@@ -616,7 +615,7 @@ function removeLinesMatching(string, match) {
   return newLines.join("\n");
 }
 function removeNonPrintableCharacters(string) {
-  return string.replaceAll(/\p{C}/gu, "");
+  return string.replaceAll(/\p{C}/gv, "");
 }
 function removeWhitespace(string) {
   return string.replaceAll(WHITESPACE_GLOBAL_REGEX, "");
@@ -641,7 +640,7 @@ function satisfiesSemanticVersion(version, minimumVersion) {
   return majorVersion > minimumMajorVersion || majorVersion === minimumMajorVersion && minorVersion > minimumMinorVersion || majorVersion === minimumMajorVersion && minorVersion === minimumMinorVersion && patchVersion >= minimumPatchVersion;
 }
 function titleCaseToKebabCase(string) {
-  return string.replaceAll(TITLE_CASE_BOUNDARY_REGEX, "-").replaceAll(/ +/g, "-").toLowerCase();
+  return string.replaceAll(TITLE_CASE_BOUNDARY_REGEX, "-").replaceAll(/ +/gv, "-").toLowerCase();
 }
 function trimPrefix(string, prefix, trimAll = false) {
   if (trimAll) {
@@ -667,11 +666,11 @@ function truncateString(string, maxLength) {
   return string.slice(0, maxLength);
 }
 
-function getElapsedSeconds(startTime) {
+function getElapsedSeconds(startTime, roundToInteger = true) {
   const endTime = Date.now();
   const elapsedMilliseconds = endTime - startTime;
   const elapsedSeconds = elapsedMilliseconds / 1e3;
-  return Math.floor(elapsedSeconds);
+  return roundToInteger ? Math.floor(elapsedSeconds) : elapsedSeconds;
 }
 
 function* tupleEntries(tuple) {
@@ -709,6 +708,7 @@ exports.assertIs = assertIs;
 exports.assertNotNull = assertNotNull;
 exports.assertNumber = assertNumber;
 exports.assertObject = assertObject;
+exports.assertPositiveInteger = assertPositiveInteger;
 exports.assertString = assertString;
 exports.assertStringNotEmpty = assertStringNotEmpty;
 exports.capitalizeFirstLetter = capitalizeFirstLetter;

package/dist/index.mjs

@@ -100,7 +100,7 @@ function assertEnumValue(value, transpiledEnum, msg, set) {
   }
 }
 function assertInteger(value, msg) {
-  if (!Number.isInteger(value)) {
+  if (!Number.isSafeInteger(value)) {
     throw new TypeError(msg);
   }
 }
@@ -124,6 +124,11 @@ function assertObject(value, ...[msg]) {
     throw new TypeError(msg);
   }
 }
+function assertPositiveInteger(value, msg) {
+  if (!Number.isSafeInteger(value) || value <= 0) {
+    throw new TypeError(msg);
+  }
+}
 function assertString(value, ...[msg]) {
   if (typeof value !== "string") {
     throw new TypeError(msg);
@@ -154,11 +159,7 @@ function getRandomInt(min, max, exceptions = []) {
 }
 
 function arrayCopyTwoDimensional(array) {
-  const copiedArray = [];
-  for (const subArray of array) {
-    copiedArray.push([...subArray]);
-  }
-  return copiedArray;
+  return Array.from(array, (subArray) => [...subArray]);
 }
 function arrayEquals(array1, array2) {
   if (array1.length !== array2.length) {
@@ -205,7 +206,7 @@ function arrayRemoveInPlace(array, ...elementsToRemove) {
   return removedElements;
 }
 function emptyArray(array) {
-  array.splice(0);
+  array.length = 0;
 }
 async function filterAsync(array, predicate) {
   const results = await Promise.all(
@@ -392,11 +393,7 @@ function combineSets(...sets) {
   return newSet;
 }
 function copySet(oldSet) {
-  const newSet = /* @__PURE__ */ new Set();
-  for (const value of oldSet) {
-    newSet.add(value);
-  }
-  return newSet;
+  return new Set(oldSet);
 }
 function objectKeysToSet(object) {
   const set = /* @__PURE__ */ new Set();
@@ -424,15 +421,13 @@ function setHas(set, ...elements) {
 function sortCaseInsensitive(array) {
   const newArray = [...array];
   newArray.sort(
-    (a, b) => a.localeCompare(b, void 0, {
-      sensitivity: "base"
-    })
+    (a, b) => a.localeCompare(b, void 0, { sensitivity: "base" })
   );
   return newArray;
 }
 
-const FLOAT_REGEX = /^-?\d*\.?\d+$/;
-const INTEGER_REGEX = /^-?\d+$/;
+const FLOAT_REGEX = /^-?(?:\d+(?:\.\d+)?|\.\d+)$/v;
+const INTEGER_REGEX = /^-?\d+$/v;
 function* eRange(start, end, increment = 1) {
   if (end === void 0) {
     yield* eRange(0, start, increment);
@@ -451,7 +446,7 @@ function* iRange(start, end, increment = 1) {
   yield* eRange(start, exclusiveEnd, increment);
 }
 function isKeyOf(key, target) {
-  return key in target;
+  return Object.hasOwn(target, key);
 }
 function noop() {
 }
@@ -460,10 +455,10 @@ function parseFloatSafe(string) {
     return void 0;
   }
   const trimmedString = string.trim();
-  if (FLOAT_REGEX.exec(trimmedString) === null) {
+  if (!FLOAT_REGEX.test(trimmedString)) {
     return void 0;
   }
-  const number = Number.parseFloat(trimmedString);
+  const number = Number(trimmedString);
   return Number.isNaN(number) ? void 0 : number;
 }
 function parseIntSafe(string) {
@@ -471,10 +466,10 @@ function parseIntSafe(string) {
     return void 0;
   }
   const trimmedString = string.trim();
-  if (INTEGER_REGEX.exec(trimmedString) === null) {
+  if (!INTEGER_REGEX.test(trimmedString)) {
     return void 0;
   }
-  const number = Number.parseInt(trimmedString, 10);
+  const number = Math.trunc(Number(trimmedString));
   return Number.isNaN(number) ? void 0 : number;
 }
 function repeat(num, func) {
@@ -485,17 +480,17 @@ function repeat(num, func) {
 function todo(...args) {
 }
 
-const ASCII_REGEX = /^[\u0000-\u007F]*$/;
-const DIACRITIC_REGEX = /\p{Diacritic}/u;
-const EMOJI_REGEX = /(\p{Extended_Pictographic}|[#*0-9]\uFE0F?\u20E3)/u;
-const FIRST_LETTER_CAPITALIZED_REGEX = /^\p{Lu}/u;
-const KEBAB_CASE_REGEX = /^[\da-z]+(?:-[\da-z]+)*$/;
-const SEMANTIC_VERSION_REGEX = /^v*(?<major>\d+)\.(?<minor>\d+)\.(?<patch>\d+)/;
-const WHITESPACE_REGEX = /\s/;
-const WHITESPACE_GLOBAL_REGEX = /\s/g;
-const TITLE_CASE_BOUNDARY_REGEX = /(?<=[\da-z])(?=[A-Z])/g;
-const UPPERCASE_REGEX = /^[A-Z]*$/;
-const LOWERCASE_REGEX = /^[a-z]*$/;
+const ASCII_REGEX = /^\p{ASCII}*$/v;
+const DIACRITIC_REGEX = /\p{Diacritic}/v;
+const FIRST_LETTER_CAPITALIZED_REGEX = /^\p{Lu}/v;
+const EMOJI_REGEX = /\p{Extended_Pictographic}|[#*0-9]\u{FE0F}?\u{20E3}/v;
+const KEBAB_CASE_REGEX = /^[\da-z]+(?:-[\da-z]+)*$/v;
+const SEMANTIC_VERSION_REGEX = /^v*(?<major>\d+)\.(?<minor>\d+)\.(?<patch>\d+)/v;
+const WHITESPACE_REGEX = /\s/v;
+const WHITESPACE_GLOBAL_REGEX = /\s/gv;
+const TITLE_CASE_BOUNDARY_REGEX = /(?<=[\da-z])(?=[A-Z])/gv;
+const UPPERCASE_REGEX = /^[A-Z]*$/v;
+const LOWERCASE_REGEX = /^[a-z]*$/v;
 function capitalizeFirstLetter(string) {
   if (string === "") {
     return string;
@@ -553,8 +548,8 @@ function isUpperCase(string) {
   return UPPERCASE_REGEX.test(string);
 }
 function kebabCaseToCamelCase(string) {
-  return string.replaceAll(/-./g, (match) => {
-    const firstLetterOfWord = match[1];
+  return string.replaceAll(/-./gv, (match) => {
+    const firstLetterOfWord = match.at(1);
     return firstLetterOfWord === void 0 ? "" : firstLetterOfWord.toUpperCase();
   });
 }
@@ -566,14 +561,14 @@ function normalizeString(string) {
   let sanitizedString = string;
   sanitizedString = removeNonPrintableCharacters(sanitizedString);
   sanitizedString = sanitizedString.replaceAll("\n\r", "\n");
-  sanitizedString = sanitizedString.replaceAll(/\p{Zl}/gu, "\n");
-  sanitizedString = sanitizedString.replaceAll(/\p{Zp}/gu, "\n");
-  sanitizedString = sanitizedString.replaceAll(/\p{Zs}/gu, " ");
+  sanitizedString = sanitizedString.replaceAll(/\p{Zl}/gv, "\n");
+  sanitizedString = sanitizedString.replaceAll(/\p{Zp}/gv, "\n");
+  sanitizedString = sanitizedString.replaceAll(/\p{Zs}/gv, " ");
   sanitizedString = sanitizedString.trim();
   return sanitizedString;
 }
 function parseSemanticVersion(versionString) {
-  const match = versionString.match(SEMANTIC_VERSION_REGEX);
+  const match = SEMANTIC_VERSION_REGEX.exec(versionString);
   if (match === null || match.groups === void 0) {
     return void 0;
   }
@@ -587,7 +582,11 @@ function parseSemanticVersion(versionString) {
   if (majorVersion === void 0 || minorVersion === void 0 || patchVersion === void 0) {
     return void 0;
   }
-  return { majorVersion, minorVersion, patchVersion };
+  return {
+    majorVersion,
+    minorVersion,
+    patchVersion
+  };
 }
 function removeLinesBetweenMarkers(string, marker) {
   const lines = string.split("\n");
@@ -614,7 +613,7 @@ function removeLinesMatching(string, match) {
   return newLines.join("\n");
 }
 function removeNonPrintableCharacters(string) {
-  return string.replaceAll(/\p{C}/gu, "");
+  return string.replaceAll(/\p{C}/gv, "");
 }
 function removeWhitespace(string) {
   return string.replaceAll(WHITESPACE_GLOBAL_REGEX, "");
@@ -639,7 +638,7 @@ function satisfiesSemanticVersion(version, minimumVersion) {
   return majorVersion > minimumMajorVersion || majorVersion === minimumMajorVersion && minorVersion > minimumMinorVersion || majorVersion === minimumMajorVersion && minorVersion === minimumMinorVersion && patchVersion >= minimumPatchVersion;
 }
 function titleCaseToKebabCase(string) {
-  return string.replaceAll(TITLE_CASE_BOUNDARY_REGEX, "-").replaceAll(/ +/g, "-").toLowerCase();
+  return string.replaceAll(TITLE_CASE_BOUNDARY_REGEX, "-").replaceAll(/ +/gv, "-").toLowerCase();
 }
 function trimPrefix(string, prefix, trimAll = false) {
   if (trimAll) {
@@ -665,11 +664,11 @@ function truncateString(string, maxLength) {
   return string.slice(0, maxLength);
 }
 
-function getElapsedSeconds(startTime) {
+function getElapsedSeconds(startTime, roundToInteger = true) {
   const endTime = Date.now();
   const elapsedMilliseconds = endTime - startTime;
   const elapsedSeconds = elapsedMilliseconds / 1e3;
-  return Math.floor(elapsedSeconds);
+  return roundToInteger ? Math.floor(elapsedSeconds) : elapsedSeconds;
 }
 
 function* tupleEntries(tuple) {
@@ -681,4 +680,4 @@ function* tupleKeys(tuple) {
 
 const ReadonlyMap = Map;
 
-export { HOUR_IN_MILLISECONDS, MINUTE_IN_MILLISECONDS, ReadonlyMap, ReadonlySet, SECOND_IN_MILLISECONDS, addSetsToSet, arrayCopyTwoDimensional, arrayEquals, arrayRemove, arrayRemoveAllInPlace, arrayRemoveInPlace, assertArray, assertArrayBoolean, assertArrayLength, assertArrayNonEmpty, assertArrayNumber, assertArrayObject, assertArrayString, assertBoolean, assertDefined, assertEnumValue, assertInteger, assertIs, assertNotNull, assertNumber, assertObject, assertString, assertStringNotEmpty, capitalizeFirstLetter, clamp, combineSets, copySet, eRange, emptyArray, escapeHTMLCharacters, filterAsync, filterMap, filterMapAsync, getElapsedSeconds, getEnumEntries, getEnumKeys, getEnumValues, getNumConsecutiveDiacritics, getRandomArrayElement, getRandomArrayIndex, getRandomInt, getWidenedObjectValue, hasDiacritic, hasEmoji, hasWhitespace, iRange, includes, includesAny, interfaceSatisfiesEnum, isASCII, isArray, isArrayBoolean, isArrayNumber, isArrayObject, isArrayString, isEnumValue, isFirstLetterCapitalized, isKebabCase, isKeyOf, isLowerCase, isObject, isSemanticVersion, isUpperCase, kebabCaseToCamelCase, kebabCaseToPascalCase, mapAsync, mapFilter, mapFind, newArray, noop, normalizeString, objectFilter, objectKeysToSet, objectMap, objectToMap, objectToReverseMap, objectValuesToSet, parseFloatSafe, parseIntSafe, parseSemanticVersion, removeLinesBetweenMarkers, removeLinesMatching, removeNonPrintableCharacters, removeWhitespace, repeat, reverseObject, satisfiesSemanticVersion, setAdd, setHas, sortCaseInsensitive, sumArray, titleCaseToKebabCase, todo, trimPrefix, trimSuffix, truncateString, tupleEntries, tupleKeys, unique };
+export { HOUR_IN_MILLISECONDS, MINUTE_IN_MILLISECONDS, ReadonlyMap, ReadonlySet, SECOND_IN_MILLISECONDS, addSetsToSet, arrayCopyTwoDimensional, arrayEquals, arrayRemove, arrayRemoveAllInPlace, arrayRemoveInPlace, assertArray, assertArrayBoolean, assertArrayLength, assertArrayNonEmpty, assertArrayNumber, assertArrayObject, assertArrayString, assertBoolean, assertDefined, assertEnumValue, assertInteger, assertIs, assertNotNull, assertNumber, assertObject, assertPositiveInteger, assertString, assertStringNotEmpty, capitalizeFirstLetter, clamp, combineSets, copySet, eRange, emptyArray, escapeHTMLCharacters, filterAsync, filterMap, filterMapAsync, getElapsedSeconds, getEnumEntries, getEnumKeys, getEnumValues, getNumConsecutiveDiacritics, getRandomArrayElement, getRandomArrayIndex, getRandomInt, getWidenedObjectValue, hasDiacritic, hasEmoji, hasWhitespace, iRange, includes, includesAny, interfaceSatisfiesEnum, isASCII, isArray, isArrayBoolean, isArrayNumber, isArrayObject, isArrayString, isEnumValue, isFirstLetterCapitalized, isKebabCase, isKeyOf, isLowerCase, isObject, isSemanticVersion, isUpperCase, kebabCaseToCamelCase, kebabCaseToPascalCase, mapAsync, mapFilter, mapFind, newArray, noop, normalizeString, objectFilter, objectKeysToSet, objectMap, objectToMap, objectToReverseMap, objectValuesToSet, parseFloatSafe, parseIntSafe, parseSemanticVersion, removeLinesBetweenMarkers, removeLinesMatching, removeNonPrintableCharacters, removeWhitespace, repeat, reverseObject, satisfiesSemanticVersion, setAdd, setHas, sortCaseInsensitive, sumArray, titleCaseToKebabCase, todo, trimPrefix, trimSuffix, truncateString, tupleEntries, tupleKeys, unique };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "complete-common",
-  "version": "2.29.0",
+  "version": "2.31.0",
   "description": "Helper functions for TypeScript projects.",
   "homepage": "https://complete-ts.github.io/",
   "bugs": {
@@ -32,10 +32,10 @@
     "test": "bun test ./tests"
   },
   "devDependencies": {
-    "@types/node": "25.6.0",
-    "complete-node": "16.4.1",
+    "@types/node": "26.0.1",
+    "complete-node": "18.0.0",
     "typedoc": "0.28.19",
-    "typedoc-plugin-markdown": "4.11.0",
+    "typedoc-plugin-markdown": "4.12.0",
     "typescript": "6.0.3",
     "unbuild": "3.6.1"
   }

package/src/functions/array.ts

@@ -17,13 +17,7 @@ import { isObject } from "./types.js";
 export function arrayCopyTwoDimensional<T>(
   array: ReadonlyArray<readonly T[]>,
 ): ReadonlyArray<readonly T[]> {
-  const copiedArray: T[][] = [];
-
-  for (const subArray of array) {
-    copiedArray.push([...subArray]);
-  }
-
-  return copiedArray;
+  return Array.from(array, (subArray) => [...subArray]);
 }
 
 /**
@@ -134,7 +128,7 @@ export function arrayRemoveInPlace<T>(
 /** Helper function to remove all of the elements in an array in-place. */
 // eslint-disable-next-line complete/prefer-readonly-parameter-types
 export function emptyArray(array: unknown[]): void {
-  array.splice(0);
+  array.length = 0; // eslint-disable-line no-param-reassign
 }
 
 /**

package/src/functions/assert.ts

@@ -114,7 +114,7 @@ export function assertArrayNumber<T>(
 
 /**
  * Helper function to throw an error if the provided value is not an array with every element being
- * an object (i.e. a TypeScript record).
+ * an object (i.e., a TypeScript record).
  */
 export function assertArrayObject<T>(
   value: T,
@@ -212,9 +212,9 @@ export function assertInteger(
   value: unknown,
   msg: string,
 ): asserts value is number {
-  // `Number.isInteger` will correctly return false for non-number variables such as strings,
+  // `Number.isSafeInteger` will correctly return false for non-number variables such as strings,
   // booleans, and so on.
-  if (!Number.isInteger(value)) {
+  if (!Number.isSafeInteger(value)) {
     throw new TypeError(msg);
   }
 }
@@ -269,7 +269,7 @@ export function assertNumber<T>(
 }
 
 /**
- * Helper function to throw an error if the provided value is not an object (i.e. a TypeScript
+ * Helper function to throw an error if the provided value is not an object (i.e., a TypeScript
  * record).
  *
  * This is useful to have TypeScript narrow a `Record<string, unknown> | undefined` value to
@@ -290,6 +290,18 @@ export function assertObject<T>(
   }
 }
 
+/** Helper function to throw an error if the provided value is not a positive integer. */
+export function assertPositiveInteger(
+  value: unknown,
+  msg: string,
+): asserts value is number {
+  // `Number.isSafeInteger` will correctly return false for non-number variables such as strings,
+  // booleans, and so on.
+  if (!Number.isSafeInteger(value) || (value as number) <= 0) {
+    throw new TypeError(msg);
+  }
+}
+
 /** Helper function to throw an error if the provided value is not a string. */
 export function assertString<T>(
   value: T,

package/src/functions/enums.ts

@@ -57,7 +57,7 @@ export function getEnumValues<T extends TranspiledEnum>(
 
 /**
  * Helper function to validate that an interface contains all of the keys of an enum. You must
- * specify both generic parameters in order for this to work properly (i.e. the interface and then
+ * specify both generic parameters in order for this to work properly (i.e., the interface and then
  * the enum).
  *
  * For example:
@@ -78,7 +78,7 @@ export function getEnumValues<T extends TranspiledEnum>(
  * interfaceSatisfiesEnum<MyEnumToType, MyEnum>();
  * ```
  *
- * This function is only meant to be used with interfaces (i.e. types that will not exist at
+ * This function is only meant to be used with interfaces (i.e., types that will not exist at
  * run-time). If you are generating an object that will contain all of the keys of an enum, use the
  * `satisfies` operator with the `Record` type instead.
  */

package/src/functions/object.ts

@@ -35,7 +35,7 @@ export function objectFilter<K extends PropertyKey, V>(
 
   // eslint-disable-next-line complete/no-for-in
   for (const key in object) {
-    const value = object[key];
+    const value = object[key]; // eslint-disable-line unicorn/no-unsafe-property-key
     const match = predicate(value);
     if (match) {
       array.push(value);

package/src/functions/set.ts

@@ -41,14 +41,9 @@ export function combineSets<T>(
   return newSet;
 }
 
-/** Helper function to copy a set. (You can also use a Set constructor to accomplish this task.) */
+/** Helper function to copy a set. (Under the hood, this simply calls the `Set` constructor.) */
 export function copySet<T>(oldSet: ReadonlySet<T>): ReadonlySet<T> {
-  const newSet = new Set<T>();
-  for (const value of oldSet) {
-    newSet.add(value);
-  }
-
-  return newSet;
+  return new Set(oldSet);
 }
 
 /** Helper function to convert the keys of an object to a set. */

package/src/functions/sort.ts

@@ -16,9 +16,7 @@ export function sortCaseInsensitive(
 ): readonly string[] {
   const newArray = [...array];
   newArray.sort((a, b) =>
-    a.localeCompare(b, undefined, {
-      sensitivity: "base",
-    }),
+    a.localeCompare(b, undefined, { sensitivity: "base" }),
   );
 
   return newArray;