@sohanemon/utils 5.0.7 → 5.0.8

package/dist/components/html-injector.d.ts

@@ -1,8 +1,8 @@
-import * as React from "react";
+import * as React from 'react';
 /**
  * Props for the HtmlInjector component
  */
-type HtmlInjectorProps = Omit<React.ComponentProps<"div">, "dangerouslySetInnerHTML"> & {
+type HtmlInjectorProps = Omit<React.ComponentProps<'div'>, 'dangerouslySetInnerHTML'> & {
     /** The HTML content to inject and render */
     html: string;
     /**

package/dist/components/html-injector.js

@@ -1,7 +1,7 @@
-"use client";
+'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
-import * as React from "react";
-import { cn } from "../functions";
+import * as React from 'react';
+import { cn } from '../functions';
 /**
  * A robust component for safely injecting and rendering HTML content with optional script execution.
  *
@@ -46,11 +46,11 @@ export function HtmlInjector({ className, html, sanitize = false, executeScripts
         if (!executeScripts || !html)
             return;
         try {
-            const tempContainer = document.createElement("div");
+            const tempContainer = document.createElement('div');
             tempContainer.innerHTML = html;
-            const scripts = tempContainer.querySelectorAll("script");
+            const scripts = tempContainer.querySelectorAll('script');
             scripts.forEach((oldScript) => {
-                const newScript = document.createElement("script");
+                const newScript = document.createElement('script');
                 // HACK: Copy text content
                 if (oldScript.textContent) {
                     newScript.textContent = oldScript.textContent;
@@ -60,14 +60,14 @@ export function HtmlInjector({ className, html, sanitize = false, executeScripts
                     newScript.setAttribute(attr.name, attr.value);
                 });
                 newScript.onerror = (error) => {
-                    console.error("Script injection error:", error);
+                    console.error('Script injection error:', error);
                 };
                 document.body.appendChild(newScript);
                 injectedScriptsRef.current.push(newScript);
             });
         }
         catch (error) {
-            console.error("HTML injection error:", error);
+            console.error('HTML injection error:', error);
         }
     }, [html, executeScripts]);
     React.useEffect(() => {
@@ -81,16 +81,16 @@ export function HtmlInjector({ className, html, sanitize = false, executeScripts
     }, []);
     const processedHtml = React.useMemo(() => {
         if (!html)
-            return "";
+            return '';
         if (sanitize) {
             // Basic sanitization - remove potentially dangerous elements
-            const container = document.createElement("div");
+            const container = document.createElement('div');
             container.innerHTML = html;
             // Remove script tags if sanitize is enabled
-            container.querySelectorAll("script").forEach((script) => script.remove());
+            container.querySelectorAll('script').forEach((script) => script.remove());
             // Remove potentially dangerous attributes
-            const dangerousAttrs = ["onclick", "onload", "onerror", "onmouseover"];
-            container.querySelectorAll("*").forEach((el) => {
+            const dangerousAttrs = ['onclick', 'onload', 'onerror', 'onmouseover'];
+            container.querySelectorAll('*').forEach((el) => {
                 dangerousAttrs.forEach((attr) => {
                     if (el.hasAttribute(attr)) {
                         el.removeAttribute(attr);

package/dist/components/index.d.ts

@@ -1,4 +1,4 @@
 export { Icon as Iconify } from '@iconify/react';
-export { MediaWrapper } from './media-wrapper';
 export { HtmlInjector } from './html-injector';
+export { MediaWrapper } from './media-wrapper';
 export { ResponsiveIndicator, ResponsiveIndicator as TailwindIndicator, } from './responsive-indicator';

package/dist/components/index.js

@@ -1,5 +1,5 @@
 'use client';
 export { Icon as Iconify } from '@iconify/react';
-export { MediaWrapper } from './media-wrapper';
 export { HtmlInjector } from './html-injector';
+export { MediaWrapper } from './media-wrapper';
 export { ResponsiveIndicator, ResponsiveIndicator as TailwindIndicator, } from './responsive-indicator';

package/dist/functions/index.d.ts

@@ -1,241 +1,4 @@
-/**
- * Utility to merge class names with Tailwind CSS and additional custom merging logic.
- *
- * @param {...ClassValue[]} inputs - Class names to merge.
- * @returns {string} - A string of merged class names.
- */
-import { type ClassValue } from 'clsx';
-import type * as React from 'react';
 export * from './cookie';
 export * from './object';
-export declare function cn(...inputs: ClassValue[]): string;
-/**
- * @deprecated Use isLinkActive instead.
- *
- * Determines if a navigation link is active based on the current path.
- *
- * @param  href - The target URL.
- * @param  path - The current browser path.
- * @returns - True if the navigation is active, false otherwise.
- */
-export declare function isNavActive(href: string, path: string): boolean;
-/**
- * Checks if a link is active, considering optional localization prefixes.
- *
- * @param {Object} params - Parameters object.
- * @param {string} params.path - The target path of the link.
- * @param {string} params.currentPath - The current browser path.
- * @param {string[]} [params.locales=['en', 'es', 'de', 'zh', 'bn', 'fr', 'it', 'nl']] - Supported locale prefixes.
- * @returns {boolean} - True if the link is active, false otherwise.
- */
-export declare function isLinkActive({ path, currentPath, locales, exact, }: {
-    path: string;
-    currentPath: string;
-    locales?: string[];
-    exact?: boolean;
-}): boolean;
-/**
- * Cleans a file path by removing the `/public/` prefix if present.
- *
- * @param  src - The source path to clean.
- * @returns - The cleaned path.
- */
-export declare function cleanSrc(src: string): string;
-/**
- * Smoothly scrolls to the top or bottom of a specified container.
- *
- * @param  containerSelector - The CSS selector or React ref for the container.
- * @param  to - Specifies whether to scroll to the top or bottom.
- */
-export declare const scrollTo: (containerSelector: string | React.RefObject<HTMLDivElement>, to: "top" | "bottom") => void;
-/**
- * Copies a given string to the clipboard.
- *
- * @param  value - The value to copy to the clipboard.
- * @param  [onSuccess=() => {}] - Optional callback executed after successful copy.
- */
-export declare const copyToClipboard: (value: string, onSuccess?: () => void) => void;
-/**
- * Converts camelCase, PascalCase, kebab-case, snake_case into normal case.
- *
- * @param  inputString - The string need to be converted into normal case
- * @returns - Normal Case
- */
-export declare function convertToNormalCase(inputString: string): string;
-/**
- * Converts a string to a URL-friendly slug by trimming, converting to lowercase,
- * replacing diacritics, removing invalid characters, and replacing spaces with hyphens.
- * @param {string} [str] - The input string to convert.
- * @returns {string} The generated slug.
- * @example
- * convertToSlug("Hello World!"); // "hello-world"
- * convertToSlug("Déjà Vu"); // "deja-vu"
- */
-export declare const convertToSlug: (str: 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>;
-type DebouncedFunction<F extends (...args: any[]) => any> = {
-    (...args: Parameters<F>): ReturnType<F> | undefined;
-    readonly isPending: boolean;
-};
-/**
- * Creates a debounced function that delays invoking the provided function until
- * after the specified `wait` time has elapsed since the last invocation.
- *
- * If the `immediate` option is set to `true`, the function will be invoked immediately
- * on the leading edge of the wait interval. Subsequent calls during the wait interval
- * will reset the timer but not invoke the function until the interval elapses again.
- *
- * The returned function includes the `isPending` property to check if the debounce
- * timer is currently active.
- *
- * @typeParam F - The type of the function to debounce.
- *
- * @param function_ - The function to debounce.
- * @param wait - The number of milliseconds to delay (default is 100ms).
- * @param options - An optional object with the following properties:
- *   - `immediate` (boolean): If `true`, invokes the function on the leading edge
- *     of the wait interval instead of the trailing edge.
- *
- * @returns A debounced version of the provided function, enhanced with the `isPending` property.
- *
- * @throws {TypeError} If the first parameter is not a function.
- * @throws {RangeError} If the `wait` parameter is negative.
- *
- * @example
- * const log = debounce((message: string) => console.log(message), 200);
- * log('Hello'); // Logs "Hello" after 200ms if no other call is made.
- * console.log(log.isPending); // true if the timer is active.
- */
-export declare function debounce<F extends (...args: any[]) => any>(function_: F, wait?: number, options?: {
-    immediate: boolean;
-}): DebouncedFunction<F>;
-type ThrottledFunction<F extends (...args: any[]) => any> = {
-    (...args: Parameters<F>): ReturnType<F> | undefined;
-    readonly isPending: boolean;
-};
-/**
- * Creates a throttled function that invokes the provided function at most once
- * every `wait` milliseconds.
- *
- * If the `leading` option is set to `true`, the function will be invoked immediately
- * on the leading edge of the throttle interval. If the `trailing` option is set to `true`,
- * the function will also be invoked at the end of the throttle interval if additional
- * calls were made during the interval.
- *
- * The returned function includes the `isPending` property to check if the throttle
- * timer is currently active.
- *
- * @typeParam F - The type of the function to throttle.
- *
- * @param function_ - The function to throttle.
- * @param wait - The number of milliseconds to wait between invocations (default is 100ms).
- * @param options - An optional object with the following properties:
- *   - `leading` (boolean): If `true`, invokes the function on the leading edge of the interval.
- *   - `trailing` (boolean): If `true`, invokes the function on the trailing edge of the interval.
- *
- * @returns A throttled version of the provided function, enhanced with the `isPending` property.
- *
- * @throws {TypeError} If the first parameter is not a function.
- * @throws {RangeError} If the `wait` parameter is negative.
- *
- * @example
- * const log = throttle((message: string) => console.log(message), 200);
- * log('Hello'); // Logs "Hello" immediately if leading is true.
- * console.log(log.isPending); // true if the timer is active.
- */
-export declare function throttle<F extends (...args: any[]) => any>(function_: F, wait?: number, options?: {
-    leading?: boolean;
-    trailing?: boolean;
-}): ThrottledFunction<F>;
-/**
- * Formats a string by replacing each '%s' placeholder with the corresponding argument.
- * This function mimics the basic behavior of C's printf for %s substitution.
- *
- * It supports both calls like `printf(format, ...args)` and `printf(format, argsArray)`.
- *
- * @param format - The format string containing '%s' placeholders.
- * @param args - The values to substitute into the placeholders, either as separate arguments or as a single array.
- * @returns The formatted string with all '%s' replaced by the provided arguments.
- *
- * @example
- * ```ts
- * const message = printf("%s love %s", "I", "Bangladesh");
- * // message === "I love Bangladesh"
- *
- * const arr = ["I", "Bangladesh"];
- * const message2 = printf("%s love %s", arr);
- * // message2 === "I love Bangladesh"
- *
- * // If there are too few arguments:
- * const incomplete = printf("Bangladesh is %s %s", "beautiful");
- * // incomplete === "Bangladesh is beautiful"
- * ```
- */
-export declare function printf(format: string, ...args: unknown[]): string;
-/**
- * Merges multiple refs into a single ref callback.
- *
- * @param refs - An array of refs to merge.
- *
- * @returns - A function that updates the merged ref with the provided value.
- */
-export type MergeRefs = <T>(...refs: Array<React.Ref<T> | undefined>) => React.RefCallback<T>;
-export declare const mergeRefs: MergeRefs;
-/**
- * Navigates to the specified client-side hash without ssr.
- * use `scroll-margin-top` with css to add margins
- *
- * @param id - The ID of the element without # to navigate to.
- *
- * @example goToClientSideHash('my-element');
- */
-export declare function goToClientSideHash(id: string, opts?: ScrollIntoViewOptions): void;
-/**
- * Escapes a string for use in a regular expression.
- *
- * @param str - The string to escape
- * @returns - The escaped string
- *
- * @example
- * const escapedString = escapeRegExp('Hello, world!');
- * // 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;
+export * from './shield';
+export * from './utils';