@sohanemon/utils 4.0.32 → 4.0.33

package/dist/functions/index.d.ts

@@ -60,3 +60,41 @@ export declare const copyToClipboard: (value: string, onSuccess?: () => void) =>
  * @returns - Normal Case
  */
 export declare function convertToNormalCase(inputString: string): string;
+/**
+ * Checks if the code is running in a server-side environment.
+ *
+ * @returns - True if the code is executed in SSR (Server-Side Rendering) context, false otherwise
+ */
+export declare const isSSR: boolean;
+/**
+ * Converts an SVG string to a Base64-encoded string.
+ *
+ * @param str - The SVG string to encode
+ * @returns - Base64-encoded string representation of the SVG
+ */
+export declare const svgToBase64: (str: string) => string;
+/**
+ * Pauses execution for the specified time.
+ *
+ * @param time - Time in milliseconds to sleep (default is 1000ms)
+ * @returns - A Promise that resolves after the specified time
+ */
+export declare const sleep: (time?: number) => Promise<unknown>;
+/**
+ * Creates a debounced function that delays invoking the provided function until
+ * after the specified wait time has elapsed since the last invocation.
+ *
+ * @param func - The function to debounce
+ * @param wait - The number of milliseconds to delay (default is 1000ms)
+ * @returns - A debounced version of the function
+ */
+export declare function debounce<T extends (...args: any[]) => void>(func: T, wait?: number): (...args: Parameters<T>) => void;
+/**
+ * Creates a throttled function that invokes the provided function at most once
+ * every specified wait time.
+ *
+ * @param func - The function to throttle
+ * @param wait - The number of milliseconds to wait (default is 1000ms)
+ * @returns - A throttled version of the function
+ */
+export declare function throttle<T extends (...args: any[]) => void>(func: T, wait?: number): (...args: Parameters<T>) => void;

package/dist/functions/index.js

@@ -105,7 +105,62 @@ export const copyToClipboard = (value, onSuccess = () => { }) => {
 export function convertToNormalCase(inputString) {
     const splittedString = inputString.split('.').pop();
     const string = splittedString || inputString;
-    const words = string.replace(/([a-z])([A-Z])/g, '$1 $2').split(/[-_|\s]+/);
+    const words = string.replace(/([a-z])([A-Z])/g, '$1 $2').split(/[-_|​\s]+/);
     const capitalizedWords = words.map((word) => word.charAt(0).toUpperCase() + word.slice(1));
     return capitalizedWords.join(' ');
 }
+/**
+ * Checks if the code is running in a server-side environment.
+ *
+ * @returns - True if the code is executed in SSR (Server-Side Rendering) context, false otherwise
+ */
+export const isSSR = typeof window === 'undefined';
+/**
+ * Converts an SVG string to a Base64-encoded string.
+ *
+ * @param str - The SVG string to encode
+ * @returns - Base64-encoded string representation of the SVG
+ */
+export const svgToBase64 = (str) => isSSR ? Buffer.from(str).toString('base64') : window.btoa(str);
+/**
+ * Pauses execution for the specified time.
+ *
+ * @param time - Time in milliseconds to sleep (default is 1000ms)
+ * @returns - A Promise that resolves after the specified time
+ */
+export const sleep = (time = 1000) => new Promise((resolve) => setTimeout(resolve, time));
+/**
+ * Creates a debounced function that delays invoking the provided function until
+ * after the specified wait time has elapsed since the last invocation.
+ *
+ * @param func - The function to debounce
+ * @param wait - The number of milliseconds to delay (default is 1000ms)
+ * @returns - A debounced version of the function
+ */
+export function debounce(func, wait = 1000) {
+    let timeout;
+    return function (...args) {
+        clearTimeout(timeout);
+        timeout = setTimeout(() => func.apply(this, args), wait);
+    };
+}
+/**
+ * Creates a throttled function that invokes the provided function at most once
+ * every specified wait time.
+ *
+ * @param func - The function to throttle
+ * @param wait - The number of milliseconds to wait (default is 1000ms)
+ * @returns - A throttled version of the function
+ */
+export function throttle(func, wait = 1000) {
+    let inThrottle = false;
+    return function (...args) {
+        if (!inThrottle) {
+            func.apply(this, args);
+            inThrottle = true;
+            setTimeout(() => {
+                inThrottle = false;
+            }, wait);
+        }
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sohanemon/utils",
-  "version": "4.0.32",
+  "version": "4.0.33",
   "author": "Sohan Emon <sohanemon@outlook.com>",
   "description": "",
   "type": "module",
@@ -15,33 +15,19 @@
   },
   "typesVersions": {
     "*": {
-      "core": [
-        "dist/index.d.ts"
-      ],
-      "types": [
-        "dist/types/index.d.ts"
-      ],
-      "hooks": [
-        "dist/hooks/index.d.ts"
-      ],
-      "components": [
-        "dist/components/index.d.ts"
-      ]
+      "core": ["dist/index.d.ts"],
+      "types": ["dist/types/index.d.ts"],
+      "hooks": ["dist/hooks/index.d.ts"],
+      "components": ["dist/components/index.d.ts"]
     }
   },
-  "files": [
-    "dist",
-    "README.md"
-  ],
+  "files": ["dist", "README.md"],
   "scripts": {
     "build": "tsc",
     "build:watch": "tsc --watch",
     "export": "tsc && npm publish"
   },
-  "keywords": [
-    "utils",
-    "cn"
-  ],
+  "keywords": ["utils", "cn"],
   "license": "ISC",
   "devDependencies": {
     "@types/node": "^22.4.0",