complete-common 2.28.0 → 2.30.0

package/dist/index.d.ts

@@ -17,8 +17,10 @@ export type * from "./interfaces/SemanticVersion.js";
 export type * from "./types/AddSubtract.js";
 export type * from "./types/CompositionTypeSatisfiesEnum.js";
 export type * from "./types/ERange.js";
+export type * from "./types/Expect.js";
 export type * from "./types/Immutable.js";
 export type * from "./types/IRange.js";
+export type * from "./types/KeysMatch.js";
 export type * from "./types/NaturalNumbersLessThan.js";
 export type * from "./types/NaturalNumbersLessThanOrEqualTo.js";
 export type * from "./types/ObjectValues.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,mBAAmB,iCAAiC,CAAC;AACrD,mBAAmB,wBAAwB,CAAC;AAC5C,mBAAmB,yCAAyC,CAAC;AAC7D,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,mCAAmC,CAAC;AACvD,mBAAmB,4CAA4C,CAAC;AAChE,mBAAmB,yBAAyB,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,mBAAmB,2BAA2B,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,mBAAmB,2BAA2B,CAAC;AAC/C,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,mBAAmB,iCAAiC,CAAC;AACrD,mBAAmB,wBAAwB,CAAC;AAC5C,mBAAmB,yCAAyC,CAAC;AAC7D,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,mCAAmC,CAAC;AACvD,mBAAmB,4CAA4C,CAAC;AAChE,mBAAmB,yBAAyB,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,mBAAmB,2BAA2B,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,mBAAmB,2BAA2B,CAAC;AAC/C,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,sBAAsB,CAAC"}

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) {
@@ -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/dist/types/Expect.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Helper type used for testing other interfaces/types. Only `true` is assignable, anything else
+ * errors.
+ */
+export type Expect<T extends true> = T;
+//# sourceMappingURL=Expect.d.ts.map

package/dist/types/Expect.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Helper type used for testing other interfaces/types. Only `true` is assignable, anything else
+ * errors.
+ */
+export type Expect<T extends true> = T;
+//# sourceMappingURL=Expect.d.ts.map

package/dist/types/Expect.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Helper type used for testing other interfaces/types. Only `true` is assignable, anything else
+ * errors.
+ */
+export type Expect<T extends true> = T;
+//# sourceMappingURL=Expect.d.ts.map

package/dist/types/Expect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Expect.d.ts","sourceRoot":"","sources":["../../src/types/Expect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC"}

package/dist/types/KeysMatch.d.cts

@@ -0,0 +1,25 @@
+/**
+ * Helper type to ensure that an array of keys matches an interface.
+ *
+ * For example:
+ *
+ * ```ts
+ * interface Foo {
+ *   arg1: string;
+ *   arg2: string;
+ * }
+ *
+ * const FOO_KEYS = ["arg1", "arg2"] as const;
+ * type _ = Expect<KeysMatch<Foo, typeof FOO_KEYS>>;
+ * ```
+ */
+export type KeysMatch<T, Keys extends readonly PropertyKey[]> = [
+    keyof T
+] extends [Keys[number]] ? [Keys[number]] extends [keyof T] ? true : {
+    error: "Extra keys not in interface";
+    extra: Exclude<Keys[number], keyof T>;
+} : {
+    error: "Missing keys from interface";
+    missing: Exclude<keyof T, Keys[number]>;
+};
+//# sourceMappingURL=KeysMatch.d.ts.map

package/dist/types/KeysMatch.d.mts

@@ -0,0 +1,25 @@
+/**
+ * Helper type to ensure that an array of keys matches an interface.
+ *
+ * For example:
+ *
+ * ```ts
+ * interface Foo {
+ *   arg1: string;
+ *   arg2: string;
+ * }
+ *
+ * const FOO_KEYS = ["arg1", "arg2"] as const;
+ * type _ = Expect<KeysMatch<Foo, typeof FOO_KEYS>>;
+ * ```
+ */
+export type KeysMatch<T, Keys extends readonly PropertyKey[]> = [
+    keyof T
+] extends [Keys[number]] ? [Keys[number]] extends [keyof T] ? true : {
+    error: "Extra keys not in interface";
+    extra: Exclude<Keys[number], keyof T>;
+} : {
+    error: "Missing keys from interface";
+    missing: Exclude<keyof T, Keys[number]>;
+};
+//# sourceMappingURL=KeysMatch.d.ts.map

package/dist/types/KeysMatch.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Helper type to ensure that an array of keys matches an interface.
+ *
+ * For example:
+ *
+ * ```ts
+ * interface Foo {
+ *   arg1: string;
+ *   arg2: string;
+ * }
+ *
+ * const FOO_KEYS = ["arg1", "arg2"] as const;
+ * type _ = Expect<KeysMatch<Foo, typeof FOO_KEYS>>;
+ * ```
+ */
+export type KeysMatch<T, Keys extends readonly PropertyKey[]> = [
+    keyof T
+] extends [Keys[number]] ? [Keys[number]] extends [keyof T] ? true : {
+    error: "Extra keys not in interface";
+    extra: Exclude<Keys[number], keyof T>;
+} : {
+    error: "Missing keys from interface";
+    missing: Exclude<keyof T, Keys[number]>;
+};
+//# sourceMappingURL=KeysMatch.d.ts.map

package/dist/types/KeysMatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeysMatch.d.ts","sourceRoot":"","sources":["../../src/types/KeysMatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,IAAI,SAAS,SAAS,WAAW,EAAE,IAAI;IAC9D,MAAM,CAAC;CACR,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GACpB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAC9B,IAAI,GACJ;IACE,KAAK,EAAE,6BAA6B,CAAC;IACrC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACvC,GACH;IACE,KAAK,EAAE,6BAA6B,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;CACzC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "complete-common",
-  "version": "2.28.0",
+  "version": "2.30.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;

package/src/functions/string.ts

@@ -14,25 +14,25 @@ import { parseIntSafe } from "./utils.js";
 // they will return inconsistent results due to the `lastIndex` property persisting between calls.
 
 /** We use a "*" instead of a "+" so that an empty string will match. */
-// eslint-disable-next-line no-control-regex
-const ASCII_REGEX = /^[\u0000-\u007F]*$/;
+const ASCII_REGEX = /^\p{ASCII}*$/v;
 
-const DIACRITIC_REGEX = /\p{Diacritic}/u;
+const DIACRITIC_REGEX = /\p{Diacritic}/v;
+const FIRST_LETTER_CAPITALIZED_REGEX = /^\p{Lu}/v;
 
 /**
- * - We can't use `/\p{Emoji}/u` because it has a false positive on "#" characters.
- * - We can't use `/\p{Extended_Pictographic}/u` because it has a false negative on keycap emojis.
+ * - We can't use `/\p{Emoji}/v` because it has a false positive on "#" characters.
+ * - We can't use `/\p{Extended_Pictographic}/v` because it has a false negative on keycap emojis.
  */
-const EMOJI_REGEX = /(\p{Extended_Pictographic}|[#*0-9]\uFE0F?\u20E3)/u;
+const EMOJI_REGEX = /\p{Extended_Pictographic}|[#*0-9]\u{FE0F}?\u{20E3}/v;
 
-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 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;
 
 /** Helper function to capitalize the first letter of a string. */
 export function capitalizeFirstLetter(string: string): string {
@@ -124,6 +124,7 @@ export function isASCII(str: string): boolean {
  * https://stackoverflow.com/questions/8334606/check-if-first-letter-of-word-is-a-capital-letter
  */
 export function isFirstLetterCapitalized(string: string): boolean {
+  // eslint-disable-next-line @typescript-eslint/prefer-string-starts-ends-with
   return FIRST_LETTER_CAPITALIZED_REGEX.test(string);
 }
 
@@ -157,8 +158,8 @@ export function isUpperCase(string: string): boolean {
 
 /** Helper function to convert a string from kebab-case to camelCase. */
 export function kebabCaseToCamelCase(string: string): string {
-  return string.replaceAll(/-./g, (match) => {
-    const firstLetterOfWord = match[1];
+  return string.replaceAll(/-./gv, (match) => {
+    const firstLetterOfWord = match.at(1);
     return firstLetterOfWord === undefined
       ? ""
       : firstLetterOfWord.toUpperCase();
@@ -189,11 +190,11 @@ export function normalizeString(string: string): string {
 
   // Normalize newlines.
   sanitizedString = sanitizedString.replaceAll("\n\r", "\n");
-  sanitizedString = sanitizedString.replaceAll(/\p{Zl}/gu, "\n");
-  sanitizedString = sanitizedString.replaceAll(/\p{Zp}/gu, "\n");
+  sanitizedString = sanitizedString.replaceAll(/\p{Zl}/gv, "\n");
+  sanitizedString = sanitizedString.replaceAll(/\p{Zp}/gv, "\n");
 
   // Normalize spaces.
-  sanitizedString = sanitizedString.replaceAll(/\p{Zs}/gu, " ");
+  sanitizedString = sanitizedString.replaceAll(/\p{Zs}/gv, " ");
 
   // Remove leading/trailing whitespace.
   sanitizedString = sanitizedString.trim();
@@ -210,7 +211,7 @@ export function normalizeString(string: string): string {
 export function parseSemanticVersion(
   versionString: string,
 ): SemanticVersion | undefined {
-  const match = versionString.match(SEMANTIC_VERSION_REGEX);
+  const match = SEMANTIC_VERSION_REGEX.exec(versionString);
   if (match === null || match.groups === undefined) {
     return undefined;
   }
@@ -232,7 +233,11 @@ export function parseSemanticVersion(
     return undefined;
   }
 
-  return { majorVersion, minorVersion, patchVersion };
+  return {
+    majorVersion,
+    minorVersion,
+    patchVersion,
+  };
 }
 
 /* eslint-disable jsdoc/escape-inline-tags */
@@ -301,7 +306,7 @@ export function removeLinesMatching(string: string, match: string): string {
  * https://stackoverflow.com/questions/11598786/how-to-replace-non-printable-unicode-characters-javascript
  */
 export function removeNonPrintableCharacters(string: string): string {
-  return string.replaceAll(/\p{C}/gu, "");
+  return string.replaceAll(/\p{C}/gv, "");
 }
 
 /** Helper function to remove all whitespace characters from a string. */
@@ -353,7 +358,7 @@ export function satisfiesSemanticVersion(
 export function titleCaseToKebabCase(string: string): string {
   return string
     .replaceAll(TITLE_CASE_BOUNDARY_REGEX, "-")
-    .replaceAll(/ +/g, "-")
+    .replaceAll(/ +/gv, "-")
     .toLowerCase();
 }
 

package/src/functions/tuple.ts

@@ -13,7 +13,7 @@ type TupleValue<T extends readonly unknown[]> = T[0];
 type TupleEntry<T extends readonly unknown[]> = [TupleKey<T>, TupleValue<T>]; // eslint-disable-line perfectionist/sort-modules
 
 /**
- * Helper function to get the entries (i.e. indexes and values) of a tuple in a type-safe way.
+ * Helper function to get the entries (i.e., indexes and values) of a tuple in a type-safe way.
  *
  * This is useful because the vanilla `Array.entries` method will always have the keys be of type
  * `number`.
@@ -25,7 +25,7 @@ export function* tupleEntries<T extends readonly unknown[]>(
 }
 
 /**
- * Helper function to get the keys (i.e. indexes) of a tuple in a type-safe way.
+ * Helper function to get the keys (i.e., indexes) of a tuple in a type-safe way.
  *
  * This is useful because the vanilla `Array.keys` method will always have the keys be of type
  * `number`.

package/src/functions/types.ts

@@ -5,7 +5,7 @@
  */
 
 /**
- * Helper function to narrow an unknown value to an object (i.e. a TypeScript record).
+ * Helper function to narrow an unknown value to an object (i.e., a TypeScript record).
  *
  * Under the hood, this checks for `typeof variable === "object"`, `variable !== null`, and
  * `!Array.isArray(variable)`.