nhb-toolbox 0.8.8 → 0.9.0

package/dist/string/index.d.ts

@@ -1,9 +1,11 @@
+import type { CapitalizeOptions } from './types';
 /**
  * Utility to convert the first letter of any string to uppercase and the rest lowercase (unless specified).
+ * Handles surrounding symbols like quotes or parentheses.
+ *
  * @param string String to be capitalized.
- * @param capEach If true, capitalizes the first letter of each word (space separated). Defaults to `false`.
- * @param lowerRest If true, ensures that the rest of the string is lowercase. Defaults to `true`.
+ * @param options Options to customize the capitalization.
  * @returns Capitalized string.
  */
-export declare const capitalizeString: (string: string, capEach?: boolean, lowerRest?: boolean) => string;
+export declare const capitalizeString: (string: string, options?: CapitalizeOptions) => string;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,WACpB,MAAM,YACL,OAAO,cACL,OAAO,KAChB,MAyBF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,WACpB,MAAM,YACJ,iBAAiB,KACzB,MA4CF,CAAC"}

package/dist/string/index.js

@@ -3,34 +3,42 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.capitalizeString = void 0;
 /**
  * Utility to convert the first letter of any string to uppercase and the rest lowercase (unless specified).
+ * Handles surrounding symbols like quotes or parentheses.
+ *
  * @param string String to be capitalized.
- * @param capEach If true, capitalizes the first letter of each word (space separated). Defaults to `false`.
- * @param lowerRest If true, ensures that the rest of the string is lowercase. Defaults to `true`.
+ * @param options Options to customize the capitalization.
  * @returns Capitalized string.
  */
-const capitalizeString = (string, capEach = false, lowerRest = true) => {
+const capitalizeString = (string, options) => {
+    if (typeof string !== 'string' || !string.trim())
+        return '';
     if (!string)
         return '';
     const trimmedString = string.trim();
     if (!trimmedString)
         return '';
-    if (capEach) {
+    const { capitalizeAll = false, capitalizeEachFirst = false, lowerCaseRest = true, } = options || {};
+    if (capitalizeAll) {
+        return trimmedString.toUpperCase();
+    }
+    if (capitalizeEachFirst) {
         return trimmedString
-            .split(' ')
-            .map((word) => (0, exports.capitalizeString)(word, false, lowerRest))
+            .split(/\s+/)
+            .map((word) => (0, exports.capitalizeString)(word, { lowerCaseRest }))
             .join(' ');
     }
-    else {
-        if (lowerRest) {
-            return trimmedString
-                .charAt(0)
-                .toUpperCase()
-                .concat(trimmedString.slice(1).toLowerCase());
-        }
-        return trimmedString
-            .charAt(0)
-            .toUpperCase()
-            .concat(trimmedString.slice(1));
+    const matchArray = trimmedString.match(/^(\W*)(\w)(.*)$/);
+    if (matchArray && matchArray.length === 4) {
+        const [_, leadingSymbols, firstLetter, rest] = matchArray;
+        return leadingSymbols
+            .concat(firstLetter.toUpperCase())
+            .concat(lowerCaseRest ? rest.toLowerCase() : rest);
     }
+    return trimmedString
+        .charAt(0)
+        .toUpperCase()
+        .concat(lowerCaseRest
+        ? trimmedString.slice(1).toLowerCase()
+        : trimmedString.slice(1));
 };
 exports.capitalizeString = capitalizeString;

package/dist/string/types.d.ts

@@ -1,2 +1,9 @@
-export type TCapitalize = (string: string, capEach?: boolean, lowerRest?: boolean) => string;
+export interface CapitalizeOptions {
+    /** If true, capitalizes the first letter of each word (space separated). Defaults to `false`. */
+    capitalizeEachFirst?: boolean;
+    /** If true, ensures that the whole string is capitalized. Defaults to `false`. */
+    capitalizeAll?: boolean;
+    /** If true, ensures that the rest of the string is lowercase. Defaults to `true`. */
+    lowerCaseRest?: boolean;
+}
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/string/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,EACjB,SAAS,CAAC,EAAE,OAAO,KACf,MAAM,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/string/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IACjC,iGAAiG;IACjG,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qFAAqF;IACrF,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "0.8.8",
+  "version": "0.9.0",
   "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",