complete-common 1.3.0 → 2.0.0

package/dist/functions/set.d.mts

@@ -16,33 +16,13 @@ export declare function addSetsToSet<T>(mainSet: Set<T>, ...setsToAdd: ReadonlyA
  *
  * This function is variadic, meaning that you can specify N sets.
  */
-export declare function combineSets<T>(...sets: ReadonlyArray<ReadonlySet<T>>): Set<T>;
+export declare function combineSets<T>(...sets: ReadonlyArray<ReadonlySet<T>>): ReadonlySet<T>;
 /** Helper function to copy a set. (You can also use a Set constructor to accomplish this task.) */
-export declare function copySet<T>(oldSet: ReadonlySet<T>): Set<T>;
-/**
- * Helper function to convert the keys of an object to a read-only set.
- *
- * Also see the `objectKeysToSet` function.
- */
-export declare function objectKeysToReadonlySet<K extends string | number | symbol, V>(object: Record<K, V>): ReadonlySet<K>;
-/**
- * Helper function to convert the keys of an object to a set.
- *
- * Also see the `objectKeysToReadonlySet` function.
- */
-export declare function objectKeysToSet<K extends string | number | symbol, V>(object: Record<K, V>): Set<K>;
-/**
- * Helper function to convert the values of an object to a read-only set.
- *
- * Also see the `objectValuesToSet` function.
- */
-export declare function objectValuesToReadonlySet<K extends string | number | symbol, V>(object: Record<K, V>): ReadonlySet<V>;
-/**
- * Helper function to convert the values of an object to a set.
- *
- * Also see the `objectValuesToReadonlySet` function.
- */
-export declare function objectValuesToSet<K extends string | number | symbol, V>(object: Record<K, V>): Set<V>;
+export declare function copySet<T>(oldSet: ReadonlySet<T>): ReadonlySet<T>;
+/** Helper function to convert the keys of an object to a set. */
+export declare function objectKeysToSet<K extends string | number | symbol, V>(object: Record<K, V>): ReadonlySet<K>;
+/** Helper function to convert the values of an object to a set. */
+export declare function objectValuesToSet<K extends string | number | symbol, V>(object: Record<K, V>): ReadonlySet<V>;
 /**
  * Helper function to add one or more elements to a set at once without having to repeatedly call
  * the `Set.add` method.

package/dist/functions/set.d.ts

@@ -16,33 +16,13 @@ export declare function addSetsToSet<T>(mainSet: Set<T>, ...setsToAdd: ReadonlyA
  *
  * This function is variadic, meaning that you can specify N sets.
  */
-export declare function combineSets<T>(...sets: ReadonlyArray<ReadonlySet<T>>): Set<T>;
+export declare function combineSets<T>(...sets: ReadonlyArray<ReadonlySet<T>>): ReadonlySet<T>;
 /** Helper function to copy a set. (You can also use a Set constructor to accomplish this task.) */
-export declare function copySet<T>(oldSet: ReadonlySet<T>): Set<T>;
-/**
- * Helper function to convert the keys of an object to a read-only set.
- *
- * Also see the `objectKeysToSet` function.
- */
-export declare function objectKeysToReadonlySet<K extends string | number | symbol, V>(object: Record<K, V>): ReadonlySet<K>;
-/**
- * Helper function to convert the keys of an object to a set.
- *
- * Also see the `objectKeysToReadonlySet` function.
- */
-export declare function objectKeysToSet<K extends string | number | symbol, V>(object: Record<K, V>): Set<K>;
-/**
- * Helper function to convert the values of an object to a read-only set.
- *
- * Also see the `objectValuesToSet` function.
- */
-export declare function objectValuesToReadonlySet<K extends string | number | symbol, V>(object: Record<K, V>): ReadonlySet<V>;
-/**
- * Helper function to convert the values of an object to a set.
- *
- * Also see the `objectValuesToReadonlySet` function.
- */
-export declare function objectValuesToSet<K extends string | number | symbol, V>(object: Record<K, V>): Set<V>;
+export declare function copySet<T>(oldSet: ReadonlySet<T>): ReadonlySet<T>;
+/** Helper function to convert the keys of an object to a set. */
+export declare function objectKeysToSet<K extends string | number | symbol, V>(object: Record<K, V>): ReadonlySet<K>;
+/** Helper function to convert the values of an object to a set. */
+export declare function objectValuesToSet<K extends string | number | symbol, V>(object: Record<K, V>): ReadonlySet<V>;
 /**
  * Helper function to add one or more elements to a set at once without having to repeatedly call
  * the `Set.add` method.

package/dist/functions/set.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../src/functions/set.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAE5B,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EACf,GAAG,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAC1C,IAAI,CAMN;AAED;;;;GAIG;AAEH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAS7E;AAED,mGAAmG;AAEnG,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAOzD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,EAC3E,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,WAAW,CAAC,CAAC,CAAC,CAEhB;AAED;;;;GAIG;AAEH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,EACnE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,GAAG,CAAC,CAAC,CAAC,CAQR;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAClC,CAAC,EACD,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAEtC;AAED;;;;GAIG;AAEH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,EACrE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,GAAG,CAAC,CAAC,CAAC,CAQR;AAED;;;;;GAKG;AAEH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAItE;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EACtB,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EACnB,GAAG,QAAQ,EAAE,SAAS,CAAC,EAAE,GACxB,OAAO,CAET"}
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../src/functions/set.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAE5B,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EACf,GAAG,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAC1C,IAAI,CAMN;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,GAAG,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACrC,WAAW,CAAC,CAAC,CAAC,CAShB;AAED,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAOjE;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,EACnE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,WAAW,CAAC,CAAC,CAAC,CAQhB;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,EACrE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,WAAW,CAAC,CAAC,CAAC,CAQhB;AAED;;;;;GAKG;AAEH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAItE;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EACtB,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EACnB,GAAG,QAAQ,EAAE,SAAS,CAAC,EAAE,GACxB,OAAO,CAET"}

package/dist/functions/sort.d.cts

@@ -10,5 +10,5 @@
  * From:
  * https://stackoverflow.com/questions/8996963/how-to-perform-case-insensitive-sorting-array-of-string-in-javascript
  */
-export declare function sortCaseInsensitive(array: readonly string[]): string[];
+export declare function sortCaseInsensitive(array: readonly string[]): readonly string[];
 //# sourceMappingURL=sort.d.ts.map

package/dist/functions/sort.d.mts

@@ -10,5 +10,5 @@
  * From:
  * https://stackoverflow.com/questions/8996963/how-to-perform-case-insensitive-sorting-array-of-string-in-javascript
  */
-export declare function sortCaseInsensitive(array: readonly string[]): string[];
+export declare function sortCaseInsensitive(array: readonly string[]): readonly string[];
 //# sourceMappingURL=sort.d.ts.map

package/dist/functions/sort.d.ts

@@ -10,5 +10,5 @@
  * From:
  * https://stackoverflow.com/questions/8996963/how-to-perform-case-insensitive-sorting-array-of-string-in-javascript
  */
-export declare function sortCaseInsensitive(array: readonly string[]): string[];
+export declare function sortCaseInsensitive(array: readonly string[]): readonly string[];
 //# sourceMappingURL=sort.d.ts.map

package/dist/functions/sort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../src/functions/sort.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AAEH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAStE"}
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../src/functions/sort.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,SAAS,MAAM,EAAE,CASnB"}

package/dist/index.cjs

@@ -6,6 +6,32 @@ const HOUR_IN_MILLISECONDS = 60 * MINUTE_IN_MILLISECONDS;
 
 const ReadonlySet = Set;
 
+function getEnumEntries(transpiledEnum) {
+  const entries = Object.entries(transpiledEnum);
+  const numberEntries = entries.filter(
+    ([_key, value]) => typeof value === "number"
+  );
+  const entriesToReturn = numberEntries.length > 0 ? numberEntries : entries;
+  return entriesToReturn;
+}
+function getEnumKeys(transpiledEnum) {
+  const enumEntries = getEnumEntries(transpiledEnum);
+  return enumEntries.map(([key, _value]) => key);
+}
+function getEnumValues(transpiledEnum) {
+  const enumEntries = getEnumEntries(transpiledEnum);
+  return enumEntries.map(([_key, value]) => value);
+}
+function interfaceSatisfiesEnum() {
+}
+function isEnumValue(value, transpiledEnum, set) {
+  if (set !== void 0) {
+    return set.has(value);
+  }
+  const enumValues = getEnumValues(transpiledEnum);
+  return enumValues.includes(value);
+}
+
 function isObject(variable) {
   return typeof variable === "object" && variable !== null && !Array.isArray(variable);
 }
@@ -25,6 +51,11 @@ function assertDefined(value, ...[msg]) {
     throw new TypeError(msg);
   }
 }
+function assertEnumValue(value, transpiledEnum, msg, set) {
+  if (!isEnumValue(value, transpiledEnum, set)) {
+    throw new TypeError(msg);
+  }
+}
 function assertNotNull(value, ...[msg]) {
   if (value === null) {
     throw new TypeError(msg);
@@ -150,32 +181,6 @@ function sumArray(array) {
   return array.reduce((accumulator, element) => accumulator + element, 0);
 }
 
-function getEnumEntries(transpiledEnum) {
-  const entries = Object.entries(transpiledEnum);
-  const numberEntries = entries.filter(
-    ([_key, value]) => typeof value === "number"
-  );
-  const entriesToReturn = numberEntries.length > 0 ? numberEntries : entries;
-  return entriesToReturn;
-}
-function getEnumKeys(transpiledEnum) {
-  const enumEntries = getEnumEntries(transpiledEnum);
-  return enumEntries.map(([key, _value]) => key);
-}
-function getEnumValues(transpiledEnum) {
-  const enumEntries = getEnumEntries(transpiledEnum);
-  return enumEntries.map(([_key, value]) => value);
-}
-function interfaceSatisfiesEnum() {
-}
-function isEnumValue(value, transpiledEnum, set) {
-  if (set !== void 0) {
-    return set.has(value);
-  }
-  const enumValues = getEnumValues(transpiledEnum);
-  return enumValues.includes(value);
-}
-
 function mapFilter(map, predicate) {
   const array = [];
   for (const value of map.values()) {
@@ -187,8 +192,8 @@ function mapFilter(map, predicate) {
   return array;
 }
 function mapFind(map, predicate) {
-  for (const value of map.values()) {
-    const match = predicate(value);
+  for (const [key, value] of map) {
+    const match = predicate(value, key, map);
     if (match) {
       return value;
     }
@@ -218,9 +223,6 @@ function objectToMap(object) {
   }
   return map;
 }
-function objectToReadonlyMap(object) {
-  return objectToMap(object);
-}
 function objectToReverseMap(object) {
   const map = /* @__PURE__ */ new Map();
   for (const [key, value] of Object.entries(object)) {
@@ -228,9 +230,6 @@ function objectToReverseMap(object) {
   }
   return map;
 }
-function objectToReverseReadonlyMap(object) {
-  return objectToReverseMap(object);
-}
 
 function addSetsToSet(mainSet, ...setsToAdd) {
   for (const set of setsToAdd) {
@@ -255,9 +254,6 @@ function copySet(oldSet) {
   }
   return newSet;
 }
-function objectKeysToReadonlySet(object) {
-  return objectKeysToSet(object);
-}
 function objectKeysToSet(object) {
   const set = /* @__PURE__ */ new Set();
   for (const key of Object.keys(object)) {
@@ -265,9 +261,6 @@ function objectKeysToSet(object) {
   }
   return set;
 }
-function objectValuesToReadonlySet(object) {
-  return objectValuesToSet(object);
-}
 function objectValuesToSet(object) {
   const set = /* @__PURE__ */ new Set();
   for (const key of Object.values(object)) {
@@ -518,6 +511,7 @@ exports.arrayRemoveInPlace = arrayRemoveInPlace;
 exports.assertArray = assertArray;
 exports.assertBoolean = assertBoolean;
 exports.assertDefined = assertDefined;
+exports.assertEnumValue = assertEnumValue;
 exports.assertNotNull = assertNotNull;
 exports.assertNumber = assertNumber;
 exports.assertObject = assertObject;
@@ -558,13 +552,9 @@ exports.newArray = newArray;
 exports.noop = noop;
 exports.normalizeString = normalizeString;
 exports.objectFilter = objectFilter;
-exports.objectKeysToReadonlySet = objectKeysToReadonlySet;
 exports.objectKeysToSet = objectKeysToSet;
 exports.objectToMap = objectToMap;
-exports.objectToReadonlyMap = objectToReadonlyMap;
 exports.objectToReverseMap = objectToReverseMap;
-exports.objectToReverseReadonlyMap = objectToReverseReadonlyMap;
-exports.objectValuesToReadonlySet = objectValuesToReadonlySet;
 exports.objectValuesToSet = objectValuesToSet;
 exports.parseFloatSafe = parseFloatSafe;
 exports.parseIntSafe = parseIntSafe;

package/dist/index.d.cts

@@ -24,6 +24,7 @@ export type * from "./types/ObjectValues.js";
 export * from "./types/ReadonlyMap.js";
 export type * from "./types/ReadonlyRecord.js";
 export * from "./types/ReadonlySet.js";
+export type * from "./types/TranspiledEnum.js";
 export type * from "./types/Tuple.js";
 export type * from "./types/WidenLiteral.js";
 export type * from "./types/Writeable.js";

package/dist/index.d.mts

@@ -24,6 +24,7 @@ export type * from "./types/ObjectValues.js";
 export * from "./types/ReadonlyMap.js";
 export type * from "./types/ReadonlyRecord.js";
 export * from "./types/ReadonlySet.js";
+export type * from "./types/TranspiledEnum.js";
 export type * from "./types/Tuple.js";
 export type * from "./types/WidenLiteral.js";
 export type * from "./types/Writeable.js";

package/dist/index.d.ts

@@ -24,6 +24,7 @@ export type * from "./types/ObjectValues.js";
 export * from "./types/ReadonlyMap.js";
 export type * from "./types/ReadonlyRecord.js";
 export * from "./types/ReadonlySet.js";
+export type * from "./types/TranspiledEnum.js";
 export type * from "./types/Tuple.js";
 export type * from "./types/WidenLiteral.js";
 export type * from "./types/Writeable.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,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,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,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"}

package/dist/index.mjs

@@ -4,6 +4,32 @@ const HOUR_IN_MILLISECONDS = 60 * MINUTE_IN_MILLISECONDS;
 
 const ReadonlySet = Set;
 
+function getEnumEntries(transpiledEnum) {
+  const entries = Object.entries(transpiledEnum);
+  const numberEntries = entries.filter(
+    ([_key, value]) => typeof value === "number"
+  );
+  const entriesToReturn = numberEntries.length > 0 ? numberEntries : entries;
+  return entriesToReturn;
+}
+function getEnumKeys(transpiledEnum) {
+  const enumEntries = getEnumEntries(transpiledEnum);
+  return enumEntries.map(([key, _value]) => key);
+}
+function getEnumValues(transpiledEnum) {
+  const enumEntries = getEnumEntries(transpiledEnum);
+  return enumEntries.map(([_key, value]) => value);
+}
+function interfaceSatisfiesEnum() {
+}
+function isEnumValue(value, transpiledEnum, set) {
+  if (set !== void 0) {
+    return set.has(value);
+  }
+  const enumValues = getEnumValues(transpiledEnum);
+  return enumValues.includes(value);
+}
+
 function isObject(variable) {
   return typeof variable === "object" && variable !== null && !Array.isArray(variable);
 }
@@ -23,6 +49,11 @@ function assertDefined(value, ...[msg]) {
     throw new TypeError(msg);
   }
 }
+function assertEnumValue(value, transpiledEnum, msg, set) {
+  if (!isEnumValue(value, transpiledEnum, set)) {
+    throw new TypeError(msg);
+  }
+}
 function assertNotNull(value, ...[msg]) {
   if (value === null) {
     throw new TypeError(msg);
@@ -148,32 +179,6 @@ function sumArray(array) {
   return array.reduce((accumulator, element) => accumulator + element, 0);
 }
 
-function getEnumEntries(transpiledEnum) {
-  const entries = Object.entries(transpiledEnum);
-  const numberEntries = entries.filter(
-    ([_key, value]) => typeof value === "number"
-  );
-  const entriesToReturn = numberEntries.length > 0 ? numberEntries : entries;
-  return entriesToReturn;
-}
-function getEnumKeys(transpiledEnum) {
-  const enumEntries = getEnumEntries(transpiledEnum);
-  return enumEntries.map(([key, _value]) => key);
-}
-function getEnumValues(transpiledEnum) {
-  const enumEntries = getEnumEntries(transpiledEnum);
-  return enumEntries.map(([_key, value]) => value);
-}
-function interfaceSatisfiesEnum() {
-}
-function isEnumValue(value, transpiledEnum, set) {
-  if (set !== void 0) {
-    return set.has(value);
-  }
-  const enumValues = getEnumValues(transpiledEnum);
-  return enumValues.includes(value);
-}
-
 function mapFilter(map, predicate) {
   const array = [];
   for (const value of map.values()) {
@@ -185,8 +190,8 @@ function mapFilter(map, predicate) {
   return array;
 }
 function mapFind(map, predicate) {
-  for (const value of map.values()) {
-    const match = predicate(value);
+  for (const [key, value] of map) {
+    const match = predicate(value, key, map);
     if (match) {
       return value;
     }
@@ -216,9 +221,6 @@ function objectToMap(object) {
   }
   return map;
 }
-function objectToReadonlyMap(object) {
-  return objectToMap(object);
-}
 function objectToReverseMap(object) {
   const map = /* @__PURE__ */ new Map();
   for (const [key, value] of Object.entries(object)) {
@@ -226,9 +228,6 @@ function objectToReverseMap(object) {
   }
   return map;
 }
-function objectToReverseReadonlyMap(object) {
-  return objectToReverseMap(object);
-}
 
 function addSetsToSet(mainSet, ...setsToAdd) {
   for (const set of setsToAdd) {
@@ -253,9 +252,6 @@ function copySet(oldSet) {
   }
   return newSet;
 }
-function objectKeysToReadonlySet(object) {
-  return objectKeysToSet(object);
-}
 function objectKeysToSet(object) {
   const set = /* @__PURE__ */ new Set();
   for (const key of Object.keys(object)) {
@@ -263,9 +259,6 @@ function objectKeysToSet(object) {
   }
   return set;
 }
-function objectValuesToReadonlySet(object) {
-  return objectValuesToSet(object);
-}
 function objectValuesToSet(object) {
   const set = /* @__PURE__ */ new Set();
   for (const key of Object.values(object)) {
@@ -503,4 +496,4 @@ function* tupleKeys(tuple) {
 
 const ReadonlyMap = Map;
 
-export { HOUR_IN_MILLISECONDS, MINUTE_IN_MILLISECONDS, ReadonlyMap, ReadonlySet, SECOND_IN_MILLISECONDS, addSetsToSet, arrayCopyTwoDimensional, arrayEquals, arrayRemove, arrayRemoveInPlace, assertArray, assertBoolean, assertDefined, assertNotNull, assertNumber, assertObject, assertString, capitalizeFirstLetter, clamp, combineSets, copySet, eRange, emptyArray, escapeHTMLCharacters, filterMap, getElapsedSeconds, getEnumEntries, getEnumKeys, getEnumValues, getNumConsecutiveDiacritics, getRandomArrayElement, getRandomArrayIndex, getRandomInt, hasDiacritic, hasEmoji, hasWhitespace, iRange, includes, interfaceSatisfiesEnum, isArray, isEnumValue, isFirstLetterCapitalized, isKebabCase, isKeyOf, isObject, isSemanticVersion, kebabCaseToCamelCase, mapFilter, mapFind, newArray, noop, normalizeString, objectFilter, objectKeysToReadonlySet, objectKeysToSet, objectToMap, objectToReadonlyMap, objectToReverseMap, objectToReverseReadonlyMap, objectValuesToReadonlySet, objectValuesToSet, parseFloatSafe, parseIntSafe, parseSemanticVersion, removeLinesBetweenMarkers, removeLinesMatching, removeNonPrintableCharacters, removeWhitespace, repeat, setAdd, setHas, sortCaseInsensitive, sumArray, todo, trimPrefix, trimSuffix, truncateString, tupleEntries, tupleKeys };
+export { HOUR_IN_MILLISECONDS, MINUTE_IN_MILLISECONDS, ReadonlyMap, ReadonlySet, SECOND_IN_MILLISECONDS, addSetsToSet, arrayCopyTwoDimensional, arrayEquals, arrayRemove, arrayRemoveInPlace, assertArray, assertBoolean, assertDefined, assertEnumValue, assertNotNull, assertNumber, assertObject, assertString, capitalizeFirstLetter, clamp, combineSets, copySet, eRange, emptyArray, escapeHTMLCharacters, filterMap, getElapsedSeconds, getEnumEntries, getEnumKeys, getEnumValues, getNumConsecutiveDiacritics, getRandomArrayElement, getRandomArrayIndex, getRandomInt, hasDiacritic, hasEmoji, hasWhitespace, iRange, includes, interfaceSatisfiesEnum, isArray, isEnumValue, isFirstLetterCapitalized, isKebabCase, isKeyOf, isObject, isSemanticVersion, kebabCaseToCamelCase, mapFilter, mapFind, newArray, noop, normalizeString, objectFilter, objectKeysToSet, objectToMap, objectToReverseMap, objectValuesToSet, parseFloatSafe, parseIntSafe, parseSemanticVersion, removeLinesBetweenMarkers, removeLinesMatching, removeNonPrintableCharacters, removeWhitespace, repeat, setAdd, setHas, sortCaseInsensitive, sumArray, todo, trimPrefix, trimSuffix, truncateString, tupleEntries, tupleKeys };

package/dist/types/TranspiledEnum.d.cts

@@ -0,0 +1,3 @@
+/** Helper type to represent a TypeScript `enum` at run-time. */
+export type TranspiledEnum = Record<string, string | number>;
+//# sourceMappingURL=TranspiledEnum.d.ts.map

package/dist/types/TranspiledEnum.d.mts

@@ -0,0 +1,3 @@
+/** Helper type to represent a TypeScript `enum` at run-time. */
+export type TranspiledEnum = Record<string, string | number>;
+//# sourceMappingURL=TranspiledEnum.d.ts.map

package/dist/types/TranspiledEnum.d.ts

@@ -0,0 +1,3 @@
+/** Helper type to represent a TypeScript `enum` at run-time. */
+export type TranspiledEnum = Record<string, string | number>;
+//# sourceMappingURL=TranspiledEnum.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TranspiledEnum.d.ts","sourceRoot":"","sources":["../../src/types/TranspiledEnum.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "complete-common",
-  "version": "1.3.0",
+  "version": "2.0.0",
   "description": "Helper functions for TypeScript projects.",
   "keywords": [],
   "homepage": "https://complete-ts.github.io/",
@@ -35,12 +35,12 @@
     "test": "glob \"./src/**/*.test.ts\" --cmd=\"node --import tsx --test --test-reporter spec\""
   },
   "devDependencies": {
-    "@types/node": "22.13.5",
-    "complete-node": "3.1.6",
+    "@types/node": "22.13.10",
+    "complete-node": "5.1.1",
     "eslint-plugin-sort-exports": "0.9.1",
     "glob": "11.0.1",
-    "typescript": "5.7.3",
-    "typescript-eslint": "8.25.0",
+    "typescript": "5.8.2",
+    "typescript-eslint": "8.26.0",
     "unbuild": "3.5.0"
   }
 }

package/src/functions/array.ts

@@ -13,10 +13,9 @@ import { getRandomInt } from "./random.js";
  * Helper function to copy a two-dimensional array. Note that the sub-arrays will only be shallow
  * copied (using the spread operator).
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function arrayCopyTwoDimensional<T>(
   array: ReadonlyArray<readonly T[]>,
-): T[][] {
+): readonly T[][] {
   const copiedArray: T[][] = [];
 
   for (const subArray of array) {
@@ -51,11 +50,10 @@ export function arrayEquals<T>(
  *
  * This function is variadic, meaning that you can specify N arguments to remove N elements.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function arrayRemove<T>(
   originalArray: readonly T[],
   ...elementsToRemove: readonly T[]
-): T[] {
+): readonly T[] {
   const elementsToRemoveSet = new ReadonlySet(elementsToRemove);
 
   const array: T[] = [];
@@ -80,12 +78,11 @@ export function arrayRemove<T>(
  *
  * @returns The removed elements. This will be an empty array if no elements were removed.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function arrayRemoveInPlace<T>(
   // eslint-disable-next-line complete/prefer-readonly-parameter-types
   array: T[],
   ...elementsToRemove: readonly T[]
-): T[] {
+): readonly T[] {
   const removedElements: T[] = [];
 
   for (const element of elementsToRemove) {
@@ -101,7 +98,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<T>(array: T[]): void {
+export function emptyArray(array: unknown[]): void {
   array.splice(0, array.length);
 }
 
@@ -116,11 +113,10 @@ export function emptyArray<T>(array: T[]): void {
  * This is named `filterMap` after the Rust function:
  * https://doc.rust-lang.org/std/iter/struct.FilterMap.html
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function filterMap<OldT, NewT>(
   array: readonly OldT[],
   func: (element: OldT) => NewT | undefined,
-): NewT[] {
+): readonly NewT[] {
   const filteredArray: NewT[] = [];
 
   for (const element of array) {
@@ -171,8 +167,8 @@ export function getRandomArrayElement<T>(
  * @param exceptions Optional. An array of indexes that will be skipped over when getting the random
  *                   index. Default is an empty array.
  */
-export function getRandomArrayIndex<T>(
-  array: readonly T[],
+export function getRandomArrayIndex(
+  array: readonly unknown[],
   exceptions: readonly number[] = [],
 ): number {
   if (array.length === 0) {
@@ -204,8 +200,7 @@ export function isArray(arg: unknown): arg is unknown[] {
 }
 
 /** Initializes an array with all elements containing the specified default value. */
-// eslint-disable-next-line complete/no-mutable-return
-export function newArray<T>(length: number, value: T): T[] {
+export function newArray<T>(length: number, value: T): readonly T[] {
   return Array.from({ length }, () => value);
 }
 

package/src/functions/assert.ts

@@ -4,6 +4,8 @@
  * @module
  */
 
+import type { TranspiledEnum } from "../types/TranspiledEnum.js";
+import { isEnumValue } from "./enums.js";
 import { isObject } from "./types.js";
 
 /** Helper function to throw an error if the provided value is not an array. */
@@ -44,6 +46,27 @@ export function assertDefined<T>(
   }
 }
 
+/**
+ * Helper function to throw an error if the provided value is not contained within an enum.
+ *
+ * @param value The value to check.
+ * @param transpiledEnum The enum to check against.
+ * @param msg The error message to throw if the check fails.
+ * @param set Optional. A set that contains all of the values of an enum. If provided, this function
+ *            will check for existence using the set (instead of the enum itself). Using a set
+ *            should be more performant for enums with around 52 or more elements.
+ */
+export function assertEnumValue<T extends TranspiledEnum>(
+  value: number | string,
+  transpiledEnum: T,
+  msg: string,
+  set?: ReadonlySet<string | number>,
+): asserts value is T[keyof T] {
+  if (!isEnumValue(value, transpiledEnum, set)) {
+    throw new TypeError(msg);
+  }
+}
+
 /**
  * Helper function to throw an error if the provided value is equal to `null`.
  *

package/src/functions/enums.ts

@@ -4,7 +4,7 @@
  * @module
  */
 
-type TranspiledEnum = Record<string, string | number>;
+import type { TranspiledEnum } from "../types/TranspiledEnum.js";
 
 /**
  * Helper function to get the entries of an enum.

package/src/functions/map.ts

@@ -14,11 +14,10 @@
  * If you want to perform a filter and a map at the same time on an array, use the `filterMap`
  * helper function instead.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function mapFilter<K, V>(
   map: ReadonlyMap<K, V>,
   predicate: (value: V) => boolean,
-): V[] {
+): readonly V[] {
   const array: V[] = [];
 
   for (const value of map.values()) {
@@ -36,13 +35,17 @@ export function mapFilter<K, V>(
  * maps.
  *
  * This is efficient such that it avoids converting the map values into an array.
+ *
+ * @param map The map to search through.
+ * @param predicate Function that tests each value for a condition.
+ * @returns The first value that satisfies the predicate, or undefined if no values satisfy.
  */
 export function mapFind<K, V>(
   map: ReadonlyMap<K, V>,
-  predicate: (value: V) => boolean,
+  predicate: (value: V, key: K, map: ReadonlyMap<K, V>) => boolean,
 ): V | undefined {
-  for (const value of map.values()) {
-    const match = predicate(value);
+  for (const [key, value] of map) {
+    const match = predicate(value, key, map);
     if (match) {
       return value;
     }