complete-common 2.3.0 → 2.4.0

package/dist/functions/string.d.cts

@@ -33,14 +33,22 @@ export declare function hasWhitespace(string: string): boolean;
  * https://stackoverflow.com/questions/8334606/check-if-first-letter-of-word-is-a-capital-letter
  */
 export declare function isFirstLetterCapitalized(string: string): boolean;
-/** Kebab case is the naming style of using all lowercase and hyphens, like "foo-bar". */
+/**
+ * "kebab-case" is the naming style of using all lowercase and hyphens, like "foo-bar".
+ *
+ * An empty string is not considered to be kebab-case.
+ */
 export declare function isKebabCase(string: string): boolean;
+/** Helper function to test if a string contains only lowercase ASCII letters (a through z). */
+export declare function isLowerCase(string: string): boolean;
 /**
  * Helper function to check if a given string is a valid Semantic Version.
  *
  * @see https://semver.org/
  */
 export declare function isSemanticVersion(versionString: string): boolean;
+/** Helper function to test if a string contains only uppercase ASCII letters (A through Z). */
+export declare function isUpperCase(string: string): boolean;
 /** 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. */

package/dist/functions/string.d.mts

@@ -33,14 +33,22 @@ export declare function hasWhitespace(string: string): boolean;
  * https://stackoverflow.com/questions/8334606/check-if-first-letter-of-word-is-a-capital-letter
  */
 export declare function isFirstLetterCapitalized(string: string): boolean;
-/** Kebab case is the naming style of using all lowercase and hyphens, like "foo-bar". */
+/**
+ * "kebab-case" is the naming style of using all lowercase and hyphens, like "foo-bar".
+ *
+ * An empty string is not considered to be kebab-case.
+ */
 export declare function isKebabCase(string: string): boolean;
+/** Helper function to test if a string contains only lowercase ASCII letters (a through z). */
+export declare function isLowerCase(string: string): boolean;
 /**
  * Helper function to check if a given string is a valid Semantic Version.
  *
  * @see https://semver.org/
  */
 export declare function isSemanticVersion(versionString: string): boolean;
+/** Helper function to test if a string contains only uppercase ASCII letters (A through Z). */
+export declare function isUpperCase(string: string): boolean;
 /** 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. */

package/dist/functions/string.d.ts

@@ -33,14 +33,22 @@ export declare function hasWhitespace(string: string): boolean;
  * https://stackoverflow.com/questions/8334606/check-if-first-letter-of-word-is-a-capital-letter
  */
 export declare function isFirstLetterCapitalized(string: string): boolean;
-/** Kebab case is the naming style of using all lowercase and hyphens, like "foo-bar". */
+/**
+ * "kebab-case" is the naming style of using all lowercase and hyphens, like "foo-bar".
+ *
+ * An empty string is not considered to be kebab-case.
+ */
 export declare function isKebabCase(string: string): boolean;
+/** Helper function to test if a string contains only lowercase ASCII letters (a through z). */
+export declare function isLowerCase(string: string): boolean;
 /**
  * Helper function to check if a given string is a valid Semantic Version.
  *
  * @see https://semver.org/
  */
 export declare function isSemanticVersion(versionString: string): boolean;
+/** Helper function to test if a string contains only uppercase ASCII letters (A through Z). */
+export declare function isUpperCase(string: string): boolean;
 /** 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. */

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;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"}
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/functions/string.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,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;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD;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

@@ -347,9 +347,11 @@ 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 = /^[\da-z]+(?:-[\da-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;
+const UPPERCASE_REGEX = /^[A-Z]*$/;
+const LOWERCASE_REGEX = /^[a-z]*$/;
 function capitalizeFirstLetter(string) {
   if (string === "") {
     return string;
@@ -392,15 +394,18 @@ function isFirstLetterCapitalized(string) {
   return FIRST_LETTER_CAPITALIZED_REGEX.test(string);
 }
 function isKebabCase(string) {
-  if (string === "") {
-    return false;
-  }
   return KEBAB_CASE_REGEX.test(string);
 }
+function isLowerCase(string) {
+  return LOWERCASE_REGEX.test(string);
+}
 function isSemanticVersion(versionString) {
   const match = versionString.match(SEMANTIC_VERSION_REGEX);
   return match !== null;
 }
+function isUpperCase(string) {
+  return UPPERCASE_REGEX.test(string);
+}
 function kebabCaseToCamelCase(string) {
   return string.replaceAll(/-./g, (match) => {
     const firstLetterOfWord = match[1];
@@ -554,8 +559,10 @@ exports.isEnumValue = isEnumValue;
 exports.isFirstLetterCapitalized = isFirstLetterCapitalized;
 exports.isKebabCase = isKebabCase;
 exports.isKeyOf = isKeyOf;
+exports.isLowerCase = isLowerCase;
 exports.isObject = isObject;
 exports.isSemanticVersion = isSemanticVersion;
+exports.isUpperCase = isUpperCase;
 exports.kebabCaseToCamelCase = kebabCaseToCamelCase;
 exports.kebabCaseToPascalCase = kebabCaseToPascalCase;
 exports.mapFilter = mapFilter;

package/dist/index.mjs

@@ -345,9 +345,11 @@ 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 = /^[\da-z]+(?:-[\da-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;
+const UPPERCASE_REGEX = /^[A-Z]*$/;
+const LOWERCASE_REGEX = /^[a-z]*$/;
 function capitalizeFirstLetter(string) {
   if (string === "") {
     return string;
@@ -390,15 +392,18 @@ function isFirstLetterCapitalized(string) {
   return FIRST_LETTER_CAPITALIZED_REGEX.test(string);
 }
 function isKebabCase(string) {
-  if (string === "") {
-    return false;
-  }
   return KEBAB_CASE_REGEX.test(string);
 }
+function isLowerCase(string) {
+  return LOWERCASE_REGEX.test(string);
+}
 function isSemanticVersion(versionString) {
   const match = versionString.match(SEMANTIC_VERSION_REGEX);
   return match !== null;
 }
+function isUpperCase(string) {
+  return UPPERCASE_REGEX.test(string);
+}
 function kebabCaseToCamelCase(string) {
   return string.replaceAll(/-./g, (match) => {
     const firstLetterOfWord = match[1];
@@ -506,4 +511,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, 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 };
+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, isLowerCase, isObject, isSemanticVersion, isUpperCase, 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.3.0",
+  "version": "2.4.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": "24.0.3",
-    "complete-node": "7.0.2",
+    "@types/node": "24.0.14",
+    "complete-node": "7.4.0",
     "eslint-plugin-sort-exports": "0.9.1",
     "glob": "11.0.3",
     "typescript": "5.8.3",
-    "typescript-eslint": "8.34.1",
+    "typescript-eslint": "8.37.0",
     "unbuild": "3.5.0"
   }
 }

package/src/functions/string.test.ts

@@ -1,6 +1,12 @@
 import { equal } from "node:assert";
 import test, { describe } from "node:test";
-import { hasDiacritic, hasEmoji, isKebabCase } from "./string.js";
+import {
+  hasDiacritic,
+  hasEmoji,
+  isKebabCase,
+  trimPrefix,
+  trimSuffix,
+} from "./string.js";
 
 describe("hasEmoji", () => {
   test("should return true for string with emoji", () => {
@@ -105,3 +111,21 @@ describe("isKebabCase", () => {
     equal(isKebabCase(""), false);
   });
 });
+
+describe("trimPrefix", () => {
+  test(() => {
+    equal(trimPrefix("foo", ""), "foo");
+    equal(trimPrefix("foo", "f"), "oo");
+    equal(trimPrefix("foo", "fo"), "o");
+    equal(trimPrefix("foo", "foo"), "");
+    equal(trimPrefix("foo", "foo1"), "foo");
+  });
+});
+
+describe("trimSuffix", () => {
+  equal(trimSuffix("foo", ""), "foo");
+  equal(trimSuffix("foo", "o"), "fo");
+  equal(trimSuffix("foo", "oo"), "f");
+  equal(trimSuffix("foo", "foo"), "");
+  equal(trimSuffix("foo", "1foo"), "foo");
+});

package/src/functions/string.ts

@@ -15,9 +15,11 @@ 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 = /^[\da-z]+(?:-[\da-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;
+const UPPERCASE_REGEX = /^[A-Z]*$/;
+const LOWERCASE_REGEX = /^[a-z]*$/;
 
 /** Helper function to capitalize the first letter of a string. */
 export function capitalizeFirstLetter(string: string): string {
@@ -107,15 +109,20 @@ export function isFirstLetterCapitalized(string: string): boolean {
   return FIRST_LETTER_CAPITALIZED_REGEX.test(string);
 }
 
-/** Kebab case is the naming style of using all lowercase and hyphens, like "foo-bar". */
+/**
+ * "kebab-case" is the naming style of using all lowercase and hyphens, like "foo-bar".
+ *
+ * An empty string is not considered to be kebab-case.
+ */
 export function isKebabCase(string: string): boolean {
-  if (string === "") {
-    return false;
-  }
-
   return KEBAB_CASE_REGEX.test(string);
 }
 
+/** Helper function to test if a string contains only lowercase ASCII letters (a through z). */
+export function isLowerCase(string: string): boolean {
+  return LOWERCASE_REGEX.test(string);
+}
+
 /**
  * Helper function to check if a given string is a valid Semantic Version.
  *
@@ -126,6 +133,11 @@ export function isSemanticVersion(versionString: string): boolean {
   return match !== null;
 }
 
+/** Helper function to test if a string contains only uppercase ASCII letters (A through Z). */
+export function isUpperCase(string: string): boolean {
+  return UPPERCASE_REGEX.test(string);
+}
+
 /** Helper function to convert a string from kebab-case to camelCase. */
 export function kebabCaseToCamelCase(string: string): string {
   return string.replaceAll(/-./g, (match) => {