@etsoo/shared 1.2.79 → 1.2.80

package/README.md

@@ -324,6 +324,7 @@ String and other related utilities
 |         objectKeys | Get two object's unqiue properties                                  |
 |      objectUpdated | Get the new object's updated fields contrast to the previous object |
 |     parseJsonArray | Try to parse JSON input to array                                    |
+|          parseName | Parse name data                                                     |
 |          parsePath | Parse path similar with node.js path.parse                          |
 |        parseString | Parse string (JSON) to specific type                                |
 |  removeEmptyValues | Remove empty values (null, undefined, '') from the input object     |

package/__tests__/Utils.ts

@@ -356,6 +356,20 @@ test("Tests for getResult", () => {
   expect(valueResult).toBe(5);
 });
 
+test("Tests for parseName", () => {
+  const nd = Utils.parseName("王小明");
+  expect(nd.familyName).toBe("王");
+  expect(nd.givenName).toBe("小明");
+
+  const nd2 = Utils.parseName("John  Smith");
+  expect(nd2.familyName).toBe("Smith");
+  expect(nd2.givenName).toBe("John");
+
+  const nd3 = Utils.parseName("单  名");
+  expect(nd3.familyName).toBe("单");
+  expect(nd3.givenName).toBe("名");
+});
+
 test("Tests for parsePath, file only", () => {
   const result = Utils.parsePath("a.jpg");
   expect(result.root).toBe("");

package/lib/cjs/Utils.d.ts

@@ -306,6 +306,15 @@ export declare namespace Utils {
      * @param keepNull Keep null value or not
      */
     export function setNestedValue(data: object, name: string, value: unknown, keepNull?: boolean): void;
+    /**
+     * Parse name
+     * @param name Name
+     * @returns Result
+     */
+    export function parseName(name: string): {
+        familyName: string | undefined;
+        givenName: string | undefined;
+    };
     /**
      * Parse path similar with node.js path.parse
      * @param path Input path

package/lib/cjs/Utils.js

@@ -647,6 +647,42 @@ var Utils;
         }
     }
     Utils.setNestedValue = setNestedValue;
+    /**
+     * Parse name
+     * @param name Name
+     * @returns Result
+     */
+    function parseName(name) {
+        // Trim
+        name = name.trim();
+        let familyName;
+        let givenName;
+        if (name.containChinese() ||
+            name.containJapanese() ||
+            name.containKorean()) {
+            // CJK characters
+            if (name.length >= 2) {
+                familyName = name[0];
+                givenName = name.substring(1).trim();
+            }
+            else {
+                familyName = name;
+            }
+        }
+        else {
+            const parts = name.split(/\s+/);
+            const len = parts.length;
+            if (len >= 2) {
+                familyName = parts[len - 1];
+                givenName = parts[0];
+            }
+            else {
+                givenName = name;
+            }
+        }
+        return { familyName, givenName };
+    }
+    Utils.parseName = parseName;
     /**
      * Parse path similar with node.js path.parse
      * @param path Input path

package/lib/mjs/Utils.d.ts

@@ -306,6 +306,15 @@ export declare namespace Utils {
      * @param keepNull Keep null value or not
      */
     export function setNestedValue(data: object, name: string, value: unknown, keepNull?: boolean): void;
+    /**
+     * Parse name
+     * @param name Name
+     * @returns Result
+     */
+    export function parseName(name: string): {
+        familyName: string | undefined;
+        givenName: string | undefined;
+    };
     /**
      * Parse path similar with node.js path.parse
      * @param path Input path

package/lib/mjs/Utils.js

@@ -644,6 +644,42 @@ export var Utils;
         }
     }
     Utils.setNestedValue = setNestedValue;
+    /**
+     * Parse name
+     * @param name Name
+     * @returns Result
+     */
+    function parseName(name) {
+        // Trim
+        name = name.trim();
+        let familyName;
+        let givenName;
+        if (name.containChinese() ||
+            name.containJapanese() ||
+            name.containKorean()) {
+            // CJK characters
+            if (name.length >= 2) {
+                familyName = name[0];
+                givenName = name.substring(1).trim();
+            }
+            else {
+                familyName = name;
+            }
+        }
+        else {
+            const parts = name.split(/\s+/);
+            const len = parts.length;
+            if (len >= 2) {
+                familyName = parts[len - 1];
+                givenName = parts[0];
+            }
+            else {
+                givenName = name;
+            }
+        }
+        return { familyName, givenName };
+    }
+    Utils.parseName = parseName;
     /**
      * Parse path similar with node.js path.parse
      * @param path Input path

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@etsoo/shared",
-  "version": "1.2.79",
+  "version": "1.2.80",
   "description": "TypeScript shared utilities and functions",
   "main": "lib/cjs/index.js",
   "module": "lib/mjs/index.js",
@@ -36,10 +36,10 @@
   },
   "homepage": "https://github.com/ETSOO/Shared#readme",
   "devDependencies": {
-    "@types/node": "^24.10.0",
-    "@vitejs/plugin-react": "^5.1.0",
-    "jsdom": "^27.1.0",
+    "@types/node": "^24.10.1",
+    "@vitejs/plugin-react": "^5.1.1",
+    "jsdom": "^27.2.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.7"
+    "vitest": "^4.0.10"
   }
 }

package/src/Utils.ts

@@ -899,6 +899,44 @@ export namespace Utils {
     }
   }
 
+  /**
+   * Parse name
+   * @param name Name
+   * @returns Result
+   */
+  export function parseName(name: string) {
+    // Trim
+    name = name.trim();
+
+    let familyName: string | undefined;
+    let givenName: string | undefined;
+
+    if (
+      name.containChinese() ||
+      name.containJapanese() ||
+      name.containKorean()
+    ) {
+      // CJK characters
+      if (name.length >= 2) {
+        familyName = name[0];
+        givenName = name.substring(1).trim();
+      } else {
+        familyName = name;
+      }
+    } else {
+      const parts = name.split(/\s+/);
+      const len = parts.length;
+      if (len >= 2) {
+        familyName = parts[len - 1];
+        givenName = parts[0];
+      } else {
+        givenName = name;
+      }
+    }
+
+    return { familyName, givenName };
+  }
+
   /**
    * Parse path similar with node.js path.parse
    * @param path Input path