@versini/ui-utilities 1.2.0 → 1.3.0

package/dist/index.d.ts

@@ -29,6 +29,15 @@ export declare const convertDDToDMS: (dd: number, lng: boolean) => {
  */
 export declare const convertLatitudeToDMS: (lat?: number) => string;
 
+/**
+ * Converts camelCase or PascalCase strings into human-readable, title-cased text
+ * by inserting spaces before uppercase characters and normalizing whitespace.
+ *
+ * @param input - The identifier-like string to humanize.
+ * @returns A title-cased, space-separated representation of the input.
+ */
+export declare const convertStringToHumanReadable: (input: string) => string;
+
 /**
  * Creates a debounced function that delays invoking the provided function until
  * after the specified wait time has elapsed since the last time the debounced

package/dist/index.js

@@ -1,12 +1,12 @@
 /*!
-  @versini/ui-utilities v1.2.0
+  @versini/ui-utilities v1.3.0
   © 2025 gizmette.com
 */
 try {
   if (!window.__VERSINI_UI_UTILITIES__) {
     window.__VERSINI_UI_UTILITIES__ = {
-      version: "1.2.0",
-      buildTime: "12/19/2025 07:11 PM EST",
+      version: "1.3.0",
+      buildTime: "12/19/2025 08:08 PM EST",
       homepage: "https://www.npmjs.com/package/@versini/ui-utilities",
       license: "MIT",
     };
@@ -192,5 +192,21 @@ try {
     const latitude = convertDDToDMS(lat, false);
     return `${latitude.deg}° ${latitude.min}' ${latitude.sec}" ${latitude.dir}`;
 };
+/**
+ * Converts camelCase or PascalCase strings into human-readable, title-cased text
+ * by inserting spaces before uppercase characters and normalizing whitespace.
+ *
+ * @param input - The identifier-like string to humanize.
+ * @returns A title-cased, space-separated representation of the input.
+ */ const convertStringToHumanReadable = (input)=>{
+    if (!input) {
+        return "";
+    }
+    const normalized = input.replace(/([A-Z])/g, " $1").replace(/\s+/g, " ").trim();
+    if (!normalized) {
+        return "";
+    }
+    return normalized.charAt(0).toUpperCase() + normalized.slice(1);
+};
 
-export { convertDDToDMS, convertLatitudeToDMS, debounce, isPWAMode, isProbablyMobile, isProbablyTablet, isProbablyiPad, isProbablyiPhone, numberFormatter, obfuscate, pluralize, unObfuscate };
+export { convertDDToDMS, convertLatitudeToDMS, convertStringToHumanReadable, debounce, isPWAMode, isProbablyMobile, isProbablyTablet, isProbablyiPad, isProbablyiPhone, numberFormatter, obfuscate, pluralize, unObfuscate };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@versini/ui-utilities",
-	"version": "1.2.0",
+	"version": "1.3.0",
 	"license": "MIT",
 	"author": "Arno Versini",
 	"publishConfig": {
@@ -39,5 +39,5 @@
 	"sideEffects": [
 		"**/*.css"
 	],
-	"gitHead": "e2ff3943a0cbf0481490bd3c8d6fc4b3f1d93b2f"
+	"gitHead": "3cd6b66a229c88f97e68f9de9cea8d4fabbb55ae"
 }