complete-common 2.1.0 → 2.3.0

package/dist/functions/array.d.cts

@@ -3,12 +3,12 @@
  *
  * @module
  */
-import type { WidenLiteral } from "../index.js";
+import type { WidenLiteral } from "../types/WidenLiteral.js";
 /**
  * Helper function to copy a two-dimensional array. Note that the sub-arrays will only be shallow
  * copied (using the spread operator).
  */
-export declare function arrayCopyTwoDimensional<T>(array: ReadonlyArray<readonly T[]>): readonly T[][];
+export declare function arrayCopyTwoDimensional<T>(array: ReadonlyArray<readonly T[]>): ReadonlyArray<readonly T[]>;
 /**
  * Helper function for determining if two arrays contain the exact same elements. Note that this
  * only performs a shallow comparison.
@@ -74,6 +74,12 @@ export declare function getRandomArrayIndex(array: readonly unknown[], exception
  * `as const` assertion.
  */
 export declare function includes<T, TupleElement extends WidenLiteral<T>>(array: readonly TupleElement[], searchElement: WidenLiteral<T>): searchElement is TupleElement;
+/**
+ * Similar to the `Array.includes` method, but accepts a variadic amount of search elements.
+ *
+ * @returns True if any of the elements are found, false otherwise.
+ */
+export declare function includesAny<T>(array: readonly T[], ...searchElements: readonly T[]): boolean;
 /** A wrapper around `Array.isArray` that narrows to `unknown[]` instead of `any[]`. */
 export declare function isArray(arg: unknown): arg is unknown[];
 /** Initializes an array with all elements containing the specified default value. */

package/dist/functions/array.d.mts

@@ -3,12 +3,12 @@
  *
  * @module
  */
-import type { WidenLiteral } from "../index.js";
+import type { WidenLiteral } from "../types/WidenLiteral.js";
 /**
  * Helper function to copy a two-dimensional array. Note that the sub-arrays will only be shallow
  * copied (using the spread operator).
  */
-export declare function arrayCopyTwoDimensional<T>(array: ReadonlyArray<readonly T[]>): readonly T[][];
+export declare function arrayCopyTwoDimensional<T>(array: ReadonlyArray<readonly T[]>): ReadonlyArray<readonly T[]>;
 /**
  * Helper function for determining if two arrays contain the exact same elements. Note that this
  * only performs a shallow comparison.
@@ -74,6 +74,12 @@ export declare function getRandomArrayIndex(array: readonly unknown[], exception
  * `as const` assertion.
  */
 export declare function includes<T, TupleElement extends WidenLiteral<T>>(array: readonly TupleElement[], searchElement: WidenLiteral<T>): searchElement is TupleElement;
+/**
+ * Similar to the `Array.includes` method, but accepts a variadic amount of search elements.
+ *
+ * @returns True if any of the elements are found, false otherwise.
+ */
+export declare function includesAny<T>(array: readonly T[], ...searchElements: readonly T[]): boolean;
 /** A wrapper around `Array.isArray` that narrows to `unknown[]` instead of `any[]`. */
 export declare function isArray(arg: unknown): arg is unknown[];
 /** Initializes an array with all elements containing the specified default value. */

package/dist/functions/array.d.ts

@@ -3,12 +3,12 @@
  *
  * @module
  */
-import type { WidenLiteral } from "../index.js";
+import type { WidenLiteral } from "../types/WidenLiteral.js";
 /**
  * Helper function to copy a two-dimensional array. Note that the sub-arrays will only be shallow
  * copied (using the spread operator).
  */
-export declare function arrayCopyTwoDimensional<T>(array: ReadonlyArray<readonly T[]>): readonly T[][];
+export declare function arrayCopyTwoDimensional<T>(array: ReadonlyArray<readonly T[]>): ReadonlyArray<readonly T[]>;
 /**
  * Helper function for determining if two arrays contain the exact same elements. Note that this
  * only performs a shallow comparison.
@@ -74,6 +74,12 @@ export declare function getRandomArrayIndex(array: readonly unknown[], exception
  * `as const` assertion.
  */
 export declare function includes<T, TupleElement extends WidenLiteral<T>>(array: readonly TupleElement[], searchElement: WidenLiteral<T>): searchElement is TupleElement;
+/**
+ * Similar to the `Array.includes` method, but accepts a variadic amount of search elements.
+ *
+ * @returns True if any of the elements are found, false otherwise.
+ */
+export declare function includesAny<T>(array: readonly T[], ...searchElements: readonly T[]): boolean;
 /** A wrapper around `Array.isArray` that narrows to `unknown[]` instead of `any[]`. */
 export declare function isArray(arg: unknown): arg is unknown[];
 /** Initializes an array with all elements containing the specified default value. */

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

@@ -1 +1 @@
-{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/functions/array.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC,GACjC,SAAS,CAAC,EAAE,EAAE,CAQhB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,MAAM,EAAE,SAAS,CAAC,EAAE,GACnB,OAAO,CAST;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,aAAa,EAAE,SAAS,CAAC,EAAE,EAC3B,GAAG,gBAAgB,EAAE,SAAS,CAAC,EAAE,GAChC,SAAS,CAAC,EAAE,CAWd;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAElC,KAAK,EAAE,CAAC,EAAE,EACV,GAAG,gBAAgB,EAAE,SAAS,CAAC,EAAE,GAChC,SAAS,CAAC,EAAE,CAYd;AAED,0EAA0E;AAE1E,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAEjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAClC,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,KAAK,IAAI,GAAG,SAAS,GACxC,SAAS,IAAI,EAAE,CAWjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,UAAU,GAAE,SAAS,CAAC,EAAO,GAC5B,CAAC,CAiBH;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,UAAU,GAAE,SAAS,MAAM,EAAO,GACjC,MAAM,CAQR;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,YAAY,SAAS,YAAY,CAAC,CAAC,CAAC,EAC9D,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,GAC7B,aAAa,IAAI,YAAY,CAG/B;AAED,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,OAAO,EAAE,CAEtD;AAED,qFAAqF;AACrF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,CAElE;AAED,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEzD"}
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/functions/array.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC,GACjC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC,CAQ7B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,MAAM,EAAE,SAAS,CAAC,EAAE,GACnB,OAAO,CAST;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,aAAa,EAAE,SAAS,CAAC,EAAE,EAC3B,GAAG,gBAAgB,EAAE,SAAS,CAAC,EAAE,GAChC,SAAS,CAAC,EAAE,CAWd;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAElC,KAAK,EAAE,CAAC,EAAE,EACV,GAAG,gBAAgB,EAAE,SAAS,CAAC,EAAE,GAChC,SAAS,CAAC,EAAE,CAYd;AAED,0EAA0E;AAE1E,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAEjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAClC,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,KAAK,IAAI,GAAG,SAAS,GACxC,SAAS,IAAI,EAAE,CAWjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,UAAU,GAAE,SAAS,CAAC,EAAO,GAC5B,CAAC,CAiBH;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,UAAU,GAAE,SAAS,MAAM,EAAO,GACjC,MAAM,CAQR;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,YAAY,SAAS,YAAY,CAAC,CAAC,CAAC,EAC9D,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,GAC7B,aAAa,IAAI,YAAY,CAG/B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,GAAG,cAAc,EAAE,SAAS,CAAC,EAAE,GAC9B,OAAO,CAET;AAED,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,OAAO,EAAE,CAEtD;AAED,qFAAqF;AACrF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,CAElE;AAED,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEzD"}

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,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"}
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/functions/string.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,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,CAMnD;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

@@ -132,7 +132,7 @@ function arrayRemoveInPlace(array, ...elementsToRemove) {
   return removedElements;
 }
 function emptyArray(array) {
-  array.splice(0, array.length);
+  array.splice(0);
 }
 function filterMap(array, func) {
   const filteredArray = [];
@@ -171,6 +171,9 @@ function includes(array, searchElement) {
   const widenedArray = array;
   return widenedArray.includes(searchElement);
 }
+function includesAny(array, ...searchElements) {
+  return searchElements.some((element) => array.includes(element));
+}
 function isArray(arg) {
   return Array.isArray(arg);
 }
@@ -344,7 +347,7 @@ function todo(...args) {
 const DIACRITIC_REGEX = /\p{Diacritic}/u;
 const EMOJI_REGEX = /(\p{Extended_Pictographic}|\p{Emoji_Component})/u;
 const FIRST_LETTER_CAPITALIZED_REGEX = /^\p{Lu}/u;
-const KEBAB_CASE_REGEX = /^([a-z](?!\d)|\d(?![a-z]))+(-?([a-z](?!\d)|\d(?![a-z])))*$|^$/;
+const KEBAB_CASE_REGEX = /^[\da-z]+(?:-[\da-z]+)*$|^$/;
 const SEMANTIC_VERSION_REGEX = /^v*(?<major>\d+)\.(?<minor>\d+)\.(?<patch>\d+)/;
 const WHITESPACE_REGEX = /\s/g;
 function capitalizeFirstLetter(string) {
@@ -389,6 +392,9 @@ function isFirstLetterCapitalized(string) {
   return FIRST_LETTER_CAPITALIZED_REGEX.test(string);
 }
 function isKebabCase(string) {
+  if (string === "") {
+    return false;
+  }
   return KEBAB_CASE_REGEX.test(string);
 }
 function isSemanticVersion(versionString) {
@@ -541,6 +547,7 @@ exports.hasEmoji = hasEmoji;
 exports.hasWhitespace = hasWhitespace;
 exports.iRange = iRange;
 exports.includes = includes;
+exports.includesAny = includesAny;
 exports.interfaceSatisfiesEnum = interfaceSatisfiesEnum;
 exports.isArray = isArray;
 exports.isEnumValue = isEnumValue;

package/dist/index.mjs

@@ -130,7 +130,7 @@ function arrayRemoveInPlace(array, ...elementsToRemove) {
   return removedElements;
 }
 function emptyArray(array) {
-  array.splice(0, array.length);
+  array.splice(0);
 }
 function filterMap(array, func) {
   const filteredArray = [];
@@ -169,6 +169,9 @@ function includes(array, searchElement) {
   const widenedArray = array;
   return widenedArray.includes(searchElement);
 }
+function includesAny(array, ...searchElements) {
+  return searchElements.some((element) => array.includes(element));
+}
 function isArray(arg) {
   return Array.isArray(arg);
 }
@@ -342,7 +345,7 @@ function todo(...args) {
 const DIACRITIC_REGEX = /\p{Diacritic}/u;
 const EMOJI_REGEX = /(\p{Extended_Pictographic}|\p{Emoji_Component})/u;
 const FIRST_LETTER_CAPITALIZED_REGEX = /^\p{Lu}/u;
-const KEBAB_CASE_REGEX = /^([a-z](?!\d)|\d(?![a-z]))+(-?([a-z](?!\d)|\d(?![a-z])))*$|^$/;
+const KEBAB_CASE_REGEX = /^[\da-z]+(?:-[\da-z]+)*$|^$/;
 const SEMANTIC_VERSION_REGEX = /^v*(?<major>\d+)\.(?<minor>\d+)\.(?<patch>\d+)/;
 const WHITESPACE_REGEX = /\s/g;
 function capitalizeFirstLetter(string) {
@@ -387,6 +390,9 @@ function isFirstLetterCapitalized(string) {
   return FIRST_LETTER_CAPITALIZED_REGEX.test(string);
 }
 function isKebabCase(string) {
+  if (string === "") {
+    return false;
+  }
   return KEBAB_CASE_REGEX.test(string);
 }
 function isSemanticVersion(versionString) {
@@ -500,4 +506,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, 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 };
+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, includesAny, 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "complete-common",
-  "version": "2.1.0",
+  "version": "2.3.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.10",
-    "complete-node": "5.1.2",
+    "@types/node": "24.0.3",
+    "complete-node": "7.0.2",
     "eslint-plugin-sort-exports": "0.9.1",
-    "glob": "11.0.1",
-    "typescript": "5.8.2",
-    "typescript-eslint": "8.26.0",
+    "glob": "11.0.3",
+    "typescript": "5.8.3",
+    "typescript-eslint": "8.34.1",
     "unbuild": "3.5.0"
   }
 }

package/src/functions/array.ts

@@ -4,8 +4,8 @@
  * @module
  */
 
-import type { WidenLiteral } from "../index.js";
 import { ReadonlySet } from "../types/ReadonlySet.js";
+import type { WidenLiteral } from "../types/WidenLiteral.js";
 import { assertDefined } from "./assert.js";
 import { getRandomInt } from "./random.js";
 
@@ -15,7 +15,7 @@ import { getRandomInt } from "./random.js";
  */
 export function arrayCopyTwoDimensional<T>(
   array: ReadonlyArray<readonly T[]>,
-): readonly T[][] {
+): ReadonlyArray<readonly T[]> {
   const copiedArray: T[][] = [];
 
   for (const subArray of array) {
@@ -99,7 +99,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);
+  array.splice(0);
 }
 
 /**
@@ -194,6 +194,18 @@ export function includes<T, TupleElement extends WidenLiteral<T>>(
   return widenedArray.includes(searchElement);
 }
 
+/**
+ * Similar to the `Array.includes` method, but accepts a variadic amount of search elements.
+ *
+ * @returns True if any of the elements are found, false otherwise.
+ */
+export function includesAny<T>(
+  array: readonly T[],
+  ...searchElements: readonly T[]
+): boolean {
+  return searchElements.some((element) => array.includes(element));
+}
+
 /** A wrapper around `Array.isArray` that narrows to `unknown[]` instead of `any[]`. */
 export function isArray(arg: unknown): arg is unknown[] {
   return Array.isArray(arg);

package/src/functions/string.test.ts

@@ -1,6 +1,6 @@
 import { equal } from "node:assert";
 import test, { describe } from "node:test";
-import { hasDiacritic, hasEmoji } from "./string.js";
+import { hasDiacritic, hasEmoji, isKebabCase } from "./string.js";
 
 describe("hasEmoji", () => {
   test("should return true for string with emoji", () => {
@@ -40,3 +40,68 @@ describe("hasDiacritic", () => {
     equal(hasDiacritic(""), false);
   });
 });
+
+describe("isKebabCase", () => {
+  test("should return true for valid kebab-case strings", () => {
+    equal(isKebabCase("hello-world"), true);
+    equal(isKebabCase("lowercase"), true);
+    equal(isKebabCase("item-123-abc"), true);
+    equal(isKebabCase("section-1a"), true);
+    equal(isKebabCase("segment-1-2-3"), true);
+    equal(isKebabCase("1-2-3"), true);
+    equal(isKebabCase("12345"), true);
+    equal(isKebabCase("fix-k8s"), true);
+  });
+
+  test("should return false for strings with uppercase letters", () => {
+    equal(isKebabCase("HelloWorld"), false);
+    equal(isKebabCase("helloWorld"), false);
+    equal(isKebabCase("Hello-World"), false);
+    equal(isKebabCase("kebab-Case"), false);
+    equal(isKebabCase("HELLO-WORLD"), false);
+    equal(isKebabCase("UPPERCASE"), false);
+  });
+
+  test("should return false for strings with spaces", () => {
+    equal(isKebabCase("hello world"), false);
+    equal(isKebabCase(" hello-world"), false);
+    equal(isKebabCase("hello-world "), false);
+    equal(isKebabCase("hello - world"), false);
+  });
+
+  test("should return false for strings with underscores", () => {
+    equal(isKebabCase("hello_world"), false);
+    equal(isKebabCase("snake_case_example"), false);
+  });
+
+  test("should return false for strings with consecutive hyphens", () => {
+    equal(isKebabCase("hello--world"), false);
+    equal(isKebabCase("a--b--c"), false);
+  });
+
+  test("should return false for strings starting or ending with a hyphen", () => {
+    equal(isKebabCase("-hello-world"), false);
+    equal(isKebabCase("hello-world-"), false);
+    equal(isKebabCase("-start"), false);
+    equal(isKebabCase("end-"), false);
+    equal(isKebabCase("-"), false);
+  });
+
+  test("should return false for strings with special characters other than hyphens", () => {
+    equal(isKebabCase("hello-world!"), false);
+    equal(isKebabCase("test@example"), false);
+    equal(isKebabCase("kebab$case"), false);
+    equal(isKebabCase("has-#-symbol"), false);
+    equal(isKebabCase("dot.case"), false);
+    equal(isKebabCase("slash/case"), false);
+  });
+
+  test("should return false for mixed separators", () => {
+    equal(isKebabCase("hello_world-foo"), false);
+    equal(isKebabCase("hello-world_bar"), false);
+  });
+
+  test("should return false for an empty string", () => {
+    equal(isKebabCase(""), false);
+  });
+});

package/src/functions/string.ts

@@ -15,11 +15,7 @@ const DIACRITIC_REGEX = /\p{Diacritic}/u;
 const EMOJI_REGEX = /(\p{Extended_Pictographic}|\p{Emoji_Component})/u;
 
 const FIRST_LETTER_CAPITALIZED_REGEX = /^\p{Lu}/u;
-
-/** From: https://github.com/expandjs/expandjs/blob/master/lib/kebabCaseRegex.js */
-const KEBAB_CASE_REGEX =
-  /^([a-z](?!\d)|\d(?![a-z]))+(-?([a-z](?!\d)|\d(?![a-z])))*$|^$/;
-
+const KEBAB_CASE_REGEX = /^[\da-z]+(?:-[\da-z]+)*$|^$/;
 const SEMANTIC_VERSION_REGEX = /^v*(?<major>\d+)\.(?<minor>\d+)\.(?<patch>\d+)/;
 const WHITESPACE_REGEX = /\s/g;
 
@@ -113,6 +109,10 @@ export function isFirstLetterCapitalized(string: string): boolean {
 
 /** Kebab case is the naming style of using all lowercase and hyphens, like "foo-bar". */
 export function isKebabCase(string: string): boolean {
+  if (string === "") {
+    return false;
+  }
+
   return KEBAB_CASE_REGEX.test(string);
 }