@sohanemon/utils 5.0.3 → 5.0.5

package/dist/functions/index.d.ts

@@ -220,3 +220,22 @@ export declare function goToClientSideHash(id: string, opts?: ScrollIntoViewOpti
  * // escapedString === 'Hello\\, world!'
  */
 export declare function escapeRegExp(str: string): string;
+/**
+ * Normalizes a string by:
+ * - Applying Unicode normalization (NFC)
+ * - Optionally removing diacritic marks (accents)
+ * - Optionally trimming leading/trailing non-alphanumeric characters
+ * - Optionally converting to lowercase
+ *
+ * @param str - The string to normalize
+ * @param options - Normalization options
+ * @param options.lowercase - Whether to convert the result to lowercase (default: true)
+ * @param options.removeAccents - Whether to remove diacritic marks like accents (default: true)
+ * @param options.removeNonAlphanumeric - Whether to trim non-alphanumeric characters from the edges (default: true)
+ * @returns The normalized string
+ */
+export declare function normalizeText(str?: string | null, options?: {
+    lowercase?: boolean;
+    removeAccents?: boolean;
+    removeNonAlphanumeric?: boolean;
+}): string;

package/dist/functions/index.js

@@ -387,3 +387,33 @@ export function goToClientSideHash(id, opts) {
 export function escapeRegExp(str) {
     return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
+/**
+ * Normalizes a string by:
+ * - Applying Unicode normalization (NFC)
+ * - Optionally removing diacritic marks (accents)
+ * - Optionally trimming leading/trailing non-alphanumeric characters
+ * - Optionally converting to lowercase
+ *
+ * @param str - The string to normalize
+ * @param options - Normalization options
+ * @param options.lowercase - Whether to convert the result to lowercase (default: true)
+ * @param options.removeAccents - Whether to remove diacritic marks like accents (default: true)
+ * @param options.removeNonAlphanumeric - Whether to trim non-alphanumeric characters from the edges (default: true)
+ * @returns The normalized string
+ */
+export function normalizeText(str, options = {}) {
+    if (!str)
+        return '';
+    const { lowercase = true, removeAccents = true, removeNonAlphanumeric = true, } = options;
+    let result = str.normalize('NFC');
+    if (removeAccents) {
+        result = result.replace(/\p{M}/gu, ''); // remove accents
+    }
+    if (removeNonAlphanumeric) {
+        result = result.replace(/^[^\p{L}\p{N}]*|[^\p{L}\p{N}]*$/gu, ''); // trim edges
+    }
+    if (lowercase) {
+        result = result.toLocaleLowerCase();
+    }
+    return result;
+}

package/dist/functions/object.d.ts

@@ -64,4 +64,30 @@ export declare function getObjectValue<T, S extends string, D>(obj: T, path: S,
  * getObjectValue({a: [{b: 1}]}, 'a.0.b') // 1
  */
 export declare function getObjectValue<T, S extends string>(obj: T, path: S): GetValue<T, SplitPath<S>> | undefined;
+/**
+ * Extend an object or function with additional properties while
+ * preserving the original type information.
+ *
+ * Works with both plain objects and callable functions since
+ * functions in JavaScript are objects too.
+ *
+ * @template T The base object or function type
+ * @template P The additional properties type
+ *
+ * @param base - The object or function to extend
+ * @param props - An object containing properties to attach
+ *
+ * @returns The same object/function, augmented with the given properties
+ *
+ * @example
+ * // Extend an object
+ * const obj = extendProps({ a: 1 }, { b: "hello" });
+ * // obj has { a: number; b: string }
+ *
+ * // Extend a function
+ * const fn = (x: number) => x * 2;
+ * const enhanced = extendProps(fn, { name: "doubler" });
+ * // enhanced is callable and also has { name: string }
+ */
+export declare function extendProps<T extends object, P extends object>(base: T, props: P): T & P;
 export {};

package/dist/functions/object.js

@@ -37,3 +37,31 @@ export function getObjectValue(obj, path, defaultValue) {
     }
     return current !== undefined ? current : defaultValue;
 }
+/**
+ * Extend an object or function with additional properties while
+ * preserving the original type information.
+ *
+ * Works with both plain objects and callable functions since
+ * functions in JavaScript are objects too.
+ *
+ * @template T The base object or function type
+ * @template P The additional properties type
+ *
+ * @param base - The object or function to extend
+ * @param props - An object containing properties to attach
+ *
+ * @returns The same object/function, augmented with the given properties
+ *
+ * @example
+ * // Extend an object
+ * const obj = extendProps({ a: 1 }, { b: "hello" });
+ * // obj has { a: number; b: string }
+ *
+ * // Extend a function
+ * const fn = (x: number) => x * 2;
+ * const enhanced = extendProps(fn, { name: "doubler" });
+ * // enhanced is callable and also has { name: string }
+ */
+export function extendProps(base, props) {
+    return Object.assign(base, props);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sohanemon/utils",
-  "version": "5.0.3",
+  "version": "5.0.5",
   "author": "Sohan Emon <sohanemon@outlook.com>",
   "description": "",
   "type": "module",