complete-common 1.4.0 → 2.1.0

package/dist/functions/string.d.cts

@@ -41,8 +41,10 @@ export declare function isKebabCase(string: string): boolean;
  * @see https://semver.org/
  */
 export declare function isSemanticVersion(versionString: string): boolean;
-/** Helper function to convert a string from kebab-case to camel-case. */
+/** Helper function to convert a string from kebab-case to camelCase. */
 export declare function kebabCaseToCamelCase(string: string): string;
+/** Helper function to convert a string from kebab-case to PascalCase. */
+export declare function kebabCaseToPascalCase(string: string): string;
 /**
  * Helper function to normalize a string. Specifically, this performs the following steps:
  *

package/dist/functions/string.d.mts

@@ -41,8 +41,10 @@ export declare function isKebabCase(string: string): boolean;
  * @see https://semver.org/
  */
 export declare function isSemanticVersion(versionString: string): boolean;
-/** Helper function to convert a string from kebab-case to camel-case. */
+/** Helper function to convert a string from kebab-case to camelCase. */
 export declare function kebabCaseToCamelCase(string: string): string;
+/** Helper function to convert a string from kebab-case to PascalCase. */
+export declare function kebabCaseToPascalCase(string: string): string;
 /**
  * Helper function to normalize a string. Specifically, this performs the following steps:
  *

package/dist/functions/string.d.ts

@@ -41,8 +41,10 @@ export declare function isKebabCase(string: string): boolean;
  * @see https://semver.org/
  */
 export declare function isSemanticVersion(versionString: string): boolean;
-/** Helper function to convert a string from kebab-case to camel-case. */
+/** Helper function to convert a string from kebab-case to camelCase. */
 export declare function kebabCaseToCamelCase(string: string): string;
+/** Helper function to convert a string from kebab-case to PascalCase. */
+export declare function kebabCaseToPascalCase(string: string): string;
 /**
  * Helper function to normalize a string. Specifically, this performs the following steps:
  *

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

@@ -1 +1 @@
-{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/functions/string.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqBlE;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAOpD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAiBtD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GACtD;IACE,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IAErB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IAErB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;CACtB,GACD,SAAS,CAwBZ;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,MAAM,CAuBR;AAED,gGAAgG;AAChG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,UAAQ,GACd,MAAM,CAWR;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOjE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMxE"}
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/functions/string.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqBlE;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAOpD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAiBtD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GACtD;IACE,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IAErB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IAErB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;CACtB,GACD,SAAS,CAwBZ;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,MAAM,CAuBR;AAED,gGAAgG;AAChG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,UAAQ,GACd,MAAM,CAWR;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOjE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMxE"}

package/dist/index.cjs

@@ -192,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;
     }
@@ -223,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)) {
@@ -233,9 +230,6 @@ function objectToReverseMap(object) {
   }
   return map;
 }
-function objectToReverseReadonlyMap(object) {
-  return objectToReverseMap(object);
-}
 
 function addSetsToSet(mainSet, ...setsToAdd) {
   for (const set of setsToAdd) {
@@ -260,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)) {
@@ -270,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)) {
@@ -413,6 +401,10 @@ function kebabCaseToCamelCase(string) {
     return firstLetterOfWord === void 0 ? "" : firstLetterOfWord.toUpperCase();
   });
 }
+function kebabCaseToPascalCase(string) {
+  const camelCase = kebabCaseToCamelCase(string);
+  return capitalizeFirstLetter(camelCase);
+}
 function normalizeString(string) {
   let sanitizedString = string;
   sanitizedString = removeNonPrintableCharacters(sanitizedString);
@@ -558,19 +550,16 @@ exports.isKeyOf = isKeyOf;
 exports.isObject = isObject;
 exports.isSemanticVersion = isSemanticVersion;
 exports.kebabCaseToCamelCase = kebabCaseToCamelCase;
+exports.kebabCaseToPascalCase = kebabCaseToPascalCase;
 exports.mapFilter = mapFilter;
 exports.mapFind = mapFind;
 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

@@ -190,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;
     }
@@ -221,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)) {
@@ -231,9 +228,6 @@ function objectToReverseMap(object) {
   }
   return map;
 }
-function objectToReverseReadonlyMap(object) {
-  return objectToReverseMap(object);
-}
 
 function addSetsToSet(mainSet, ...setsToAdd) {
   for (const set of setsToAdd) {
@@ -258,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)) {
@@ -268,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)) {
@@ -411,6 +399,10 @@ function kebabCaseToCamelCase(string) {
     return firstLetterOfWord === void 0 ? "" : firstLetterOfWord.toUpperCase();
   });
 }
+function kebabCaseToPascalCase(string) {
+  const camelCase = kebabCaseToCamelCase(string);
+  return capitalizeFirstLetter(camelCase);
+}
 function normalizeString(string) {
   let sanitizedString = string;
   sanitizedString = removeNonPrintableCharacters(sanitizedString);
@@ -508,4 +500,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, 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, 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, kebabCaseToPascalCase, 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.4.0",
+  "version": "2.1.0",
   "description": "Helper functions for TypeScript projects.",
   "keywords": [],
   "homepage": "https://complete-ts.github.io/",
@@ -35,8 +35,8 @@
     "test": "glob \"./src/**/*.test.ts\" --cmd=\"node --import tsx --test --test-reporter spec\""
   },
   "devDependencies": {
-    "@types/node": "22.13.9",
-    "complete-node": "5.1.1",
+    "@types/node": "22.13.10",
+    "complete-node": "5.1.2",
     "eslint-plugin-sort-exports": "0.9.1",
     "glob": "11.0.1",
     "typescript": "5.8.2",

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) {
@@ -116,11 +113,10 @@ export function emptyArray(array: unknown[]): 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) {
@@ -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,7 +4,7 @@
  * @module
  */
 
-import type { TranspiledEnum } from "./enums.js";
+import type { TranspiledEnum } from "../types/TranspiledEnum.js";
 import { isEnumValue } from "./enums.js";
 import { isObject } from "./types.js";
 

package/src/functions/enums.ts

@@ -4,7 +4,7 @@
  * @module
  */
 
-export 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;
     }

package/src/functions/object.ts

@@ -12,11 +12,10 @@ import type { ReadonlyRecord } from "../types/ReadonlyRecord.js";
  *
  * This is efficient such that it avoids converting the object values into an array.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function objectFilter<K extends string | number | symbol, V>(
   object: ReadonlyRecord<K, V>,
   predicate: (value: V) => boolean,
-): V[] {
+): readonly V[] {
   const array: V[] = [];
 
   // eslint-disable-next-line complete/no-for-in
@@ -41,13 +40,10 @@ export function objectFilter<K extends string | number | symbol, V>(
  *
  * Note that the converted map will only have string keys, due to the nature of JavaScript objects
  * only having string keys under the hood.
- *
- * Also see the `objectToReadonlyMap` function.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function objectToMap<K extends string | number | symbol, V>(
   object: Record<K, V>,
-): Map<K, V> {
+): ReadonlyMap<K, V> {
   const map = new Map<K, V>();
 
   for (const [key, value] of Object.entries(object)) {
@@ -57,38 +53,16 @@ export function objectToMap<K extends string | number | symbol, V>(
   return map;
 }
 
-/**
- * Helper function to convert an object to a read-only map.
- *
- * This is useful when you need to construct a type safe object with the `satisfies` operator, but
- * then later on you need to query it in a way where you expect the return value to be T or
- * undefined. In this situation, by converting the object to a map, you can avoid unsafe type
- * assertions.
- *
- * Note that the converted map will only have string keys, due to the nature of JavaScript objects
- * only having string keys under the hood.
- *
- * Also see the `objectToMap` function.
- */
-export function objectToReadonlyMap<K extends string | number | symbol, V>(
-  object: Record<K, V>,
-): ReadonlyMap<K, V> {
-  return objectToMap(object);
-}
-
 /**
  * Helper function to convert an object to a reverse map.
  *
  * Note that the converted map will only have string keys, due to the nature of JavaScript objects
  * only having string keys under the hood.
- *
- * Also see the `objectToReverseReadonlyMap` function.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function objectToReverseMap<
   K extends string | number | symbol,
   V extends string | number | symbol,
->(object: Record<K, V>): Map<V, K> {
+>(object: Record<K, V>): ReadonlyMap<V, K> {
   const map = new Map<V, K>();
 
   for (const [key, value] of Object.entries(object)) {
@@ -97,18 +71,3 @@ export function objectToReverseMap<
 
   return map;
 }
-
-/**
- * Helper function to convert an object to a reverse read-only map.
- *
- * Note that the converted map will only have string keys, due to the nature of JavaScript objects
- * only having string keys under the hood.
- *
- * Also see the `objectToReverseMap` function.
- */
-export function objectToReverseReadonlyMap<
-  K extends string | number | symbol,
-  V extends string | number | symbol,
->(object: Record<K, V>): ReadonlyMap<V, K> {
-  return objectToReverseMap(object);
-}

package/src/functions/set.ts

@@ -28,8 +28,9 @@ export function addSetsToSet<T>(
  *
  * This function is variadic, meaning that you can specify N sets.
  */
-// eslint-disable-next-line complete/no-mutable-return
-export function combineSets<T>(...sets: ReadonlyArray<ReadonlySet<T>>): Set<T> {
+export function combineSets<T>(
+  ...sets: ReadonlyArray<ReadonlySet<T>>
+): ReadonlySet<T> {
   const newSet = new Set<T>();
   for (const set of sets) {
     for (const value of set) {
@@ -41,8 +42,7 @@ export function combineSets<T>(...sets: ReadonlyArray<ReadonlySet<T>>): Set<T> {
 }
 
 /** Helper function to copy a set. (You can also use a Set constructor to accomplish this task.) */
-// eslint-disable-next-line complete/no-mutable-return
-export function copySet<T>(oldSet: ReadonlySet<T>): Set<T> {
+export function copySet<T>(oldSet: ReadonlySet<T>): ReadonlySet<T> {
   const newSet = new Set<T>();
   for (const value of oldSet) {
     newSet.add(value);
@@ -51,26 +51,10 @@ export function copySet<T>(oldSet: ReadonlySet<T>): Set<T> {
   return newSet;
 }
 
-/**
- * Helper function to convert the keys of an object to a read-only set.
- *
- * Also see the `objectKeysToSet` function.
- */
-export function objectKeysToReadonlySet<K extends string | number | symbol, V>(
-  object: Record<K, V>,
-): ReadonlySet<K> {
-  return objectKeysToSet(object);
-}
-
-/**
- * Helper function to convert the keys of an object to a set.
- *
- * Also see the `objectKeysToReadonlySet` function.
- */
-// eslint-disable-next-line complete/no-mutable-return
+/** Helper function to convert the keys of an object to a set. */
 export function objectKeysToSet<K extends string | number | symbol, V>(
   object: Record<K, V>,
-): Set<K> {
+): ReadonlySet<K> {
   const set = new Set<K>();
 
   for (const key of Object.keys(object)) {
@@ -80,27 +64,10 @@ export function objectKeysToSet<K extends string | number | symbol, V>(
   return set;
 }
 
-/**
- * Helper function to convert the values of an object to a read-only set.
- *
- * Also see the `objectValuesToSet` function.
- */
-export function objectValuesToReadonlySet<
-  K extends string | number | symbol,
-  V,
->(object: Record<K, V>): ReadonlySet<V> {
-  return objectValuesToSet(object);
-}
-
-/**
- * Helper function to convert the values of an object to a set.
- *
- * Also see the `objectValuesToReadonlySet` function.
- */
-// eslint-disable-next-line complete/no-mutable-return
+/** Helper function to convert the values of an object to a set. */
 export function objectValuesToSet<K extends string | number | symbol, V>(
   object: Record<K, V>,
-): Set<V> {
+): ReadonlySet<V> {
   const set = new Set<V>();
 
   for (const key of Object.values(object)) {

package/src/functions/sort.ts

@@ -11,8 +11,9 @@
  * From:
  * https://stackoverflow.com/questions/8996963/how-to-perform-case-insensitive-sorting-array-of-string-in-javascript
  */
-// eslint-disable-next-line complete/no-mutable-return
-export function sortCaseInsensitive(array: readonly string[]): string[] {
+export function sortCaseInsensitive(
+  array: readonly string[],
+): readonly string[] {
   const newArray = [...array];
   newArray.sort((a, b) =>
     a.localeCompare(b, undefined, {

package/src/functions/string.ts

@@ -126,7 +126,7 @@ export function isSemanticVersion(versionString: string): boolean {
   return match !== null;
 }
 
-/** Helper function to convert a string from kebab-case to camel-case. */
+/** 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];
@@ -136,6 +136,12 @@ export function kebabCaseToCamelCase(string: string): string {
   });
 }
 
+/** Helper function to convert a string from kebab-case to PascalCase. */
+export function kebabCaseToPascalCase(string: string): string {
+  const camelCase = kebabCaseToCamelCase(string);
+  return capitalizeFirstLetter(camelCase);
+}
+
 /**
  * Helper function to normalize a string. Specifically, this performs the following steps:
  *

package/src/index.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/src/types/TranspiledEnum.ts

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