@sohanemon/utils 6.3.2 → 6.3.4

package/dist/index-BZaFEd2-.d.ts

@@ -0,0 +1,497 @@
+import { ClassValue } from "clsx";
+import * as React from "react";
+
+//#region src/functions/cookie.d.ts
+declare const setClientSideCookie: (name: string, value: string, days?: number, path?: string) => void;
+declare const deleteClientSideCookie: (name: string, path?: string) => void;
+declare const hasClientSideCookie: (name: string) => boolean;
+declare const getClientSideCookie: (name: string) => {
+  value: string | undefined;
+};
+//#endregion
+//#region src/functions/deepmerge.d.ts
+type TAllKeys<T> = T extends any ? keyof T : never;
+type TIndexValue<T, K$1 extends PropertyKey, D = never> = T extends any ? K$1 extends keyof T ? T[K$1] : D : never;
+type TPartialKeys<T, K$1 extends keyof T> = Omit<T, K$1> & Partial<Pick<T, K$1>> extends infer O ? { [P in keyof O]: O[P] } : never;
+type TFunction = (...a: any[]) => any;
+type TPrimitives = string | number | boolean | bigint | symbol | Date | TFunction;
+type TMerged<T> = [T] extends [Array<any>] ? { [K in keyof T]: TMerged<T[K]> } : [T] extends [TPrimitives] ? T : [T] extends [object] ? TPartialKeys<{ [K in TAllKeys<T>]: TMerged<TIndexValue<T, K>> }, never> : T;
+/**
+ * Deeply merges multiple objects, with later sources taking precedence.
+ * Handles nested objects, arrays, and special object types with circular reference detection.
+ *
+ * Features:
+ * - Deep merging of nested objects
+ * - Configurable array merging strategies
+ * - Circular reference detection and handling
+ * - Support for symbols and special objects (Date, RegExp, etc.)
+ * - Type-safe with improved generics
+ * - Optional cloning to avoid mutation
+ * - Custom merge functions for specific keys
+ *
+ * @template T - The target object type
+ * @param target - The target object to merge into
+ * @param sources - Source objects to merge from (can have additional properties)
+ * @param options - Configuration options
+ * @param options.arrayMerge - How to merge arrays: 'replace' (default), 'concat', or 'merge'
+ * @param options.clone - Whether to clone the target (default: true)
+ * @param options.customMerge - Custom merge function for specific keys
+ * @param options.maxDepth - Maximum recursion depth (default: 100)
+ * @returns The merged object with proper typing
+ *
+ * @example
+ * // Basic merge
+ * deepmerge({ a: 1 }, { b: 2 }) // { a: 1, b: 2 }
+ *
+ * @example
+ * // Nested merge
+ * deepmerge({ a: { x: 1 } }, { a: { y: 2 } }) // { a: { x: 1, y: 2 } }
+ *
+ * @example
+ * // Array concat
+ * deepmerge({ arr: [1] }, { arr: [2] }, { arrayMerge: 'concat' }) // { arr: [1, 2] }
+ *
+ * @example
+ * // Sources with extra properties
+ * deepmerge({ a: 1 }, { b: 2, c: 3 }) // { a: 1, b: 2, c: 3 }
+ */
+declare function deepmerge<T extends Record<string, any>, S extends Record<string, any>[]>(target: T, ...sources: S): TMerged<T | S[number]>;
+declare function deepmerge<T extends Record<string, any>, S extends Record<string, any>[]>(target: T, sources: S, options?: {
+  arrayMerge?: 'replace' | 'concat' | 'merge' | ((target: any[], source: any[]) => any[]);
+  clone?: boolean;
+  customMerge?: (key: string | symbol, targetValue: any, sourceValue: any) => any;
+  maxDepth?: number;
+}): TMerged<T | S[number]>;
+//#endregion
+//#region src/functions/hydrate.d.ts
+type Hydrate<T> = T extends null ? undefined : T extends (infer U)[] ? Hydrate<U>[] : T extends object ? { [K in keyof T]: Hydrate<T[K]> } : T;
+/**
+ * Converts all `null` values to `undefined` in the data structure recursively.
+ *
+ * @param data - Any input data (object, array, primitive)
+ * @returns Same type as input, but with all nulls replaced by undefined
+ *
+ * @example
+ * hydrate({ a: null, b: 'test' }) // { a: undefined, b: 'test' }
+ * hydrate([null, 1, { c: null }]) // [undefined, 1, { c: undefined }]
+ */
+declare function hydrate<T>(data: T): Hydrate<T>;
+//#endregion
+//#region src/functions/object.d.ts
+/**
+ * Type representing a path split into segments
+ * @template S - The original path string type
+ */
+type SplitPath<S extends string> = S extends `${infer First}.${infer Rest}` ? [First, ...SplitPath<Rest>] : [S];
+/**
+ * Recursive type to resolve nested object types based on path
+ * @template T - Current object type
+ * @template K - Array of path segments
+ */
+type GetValue<T, K$1 extends Array<string | number>> = K$1 extends [infer First, ...infer Rest] ? First extends keyof T ? GetValue<T[First], Rest extends Array<string | number> ? Rest : []> : First extends `${number}` ? T extends any[] ? GetValue<T[number], Rest extends Array<string | number> ? Rest : []> : undefined : undefined : T;
+/**
+ * Get a nested value from an object using array path segments
+ * @template T - Object type
+ * @template K - Path segments array type
+ * @template D - Default value type
+ * @param obj - Source object
+ * @param path - Array of path segments
+ * @param defaultValue - Fallback value if path not found
+ * @returns Value at path or default value
+ *
+ * @example
+ * getObjectValue({a: [{b: 1}]}, ['a', 0, 'b']) // 1
+ */
+declare function getObjectValue<T, K$1 extends Array<string | number>, D>(obj: T, path: K$1, defaultValue: D): Exclude<GetValue<T, K$1>, undefined> | D;
+/**
+ * Get a nested value from an object using array path segments
+ * @template T - Object type
+ * @template K - Path segments array type
+ * @param obj - Source object
+ * @param path - Array of path segments
+ * @returns Value at path or undefined
+ *
+ * @example
+ * getObjectValue({a: [{b: 1}]}, ['a', 0, 'b']) // 1
+ */
+declare function getObjectValue<T, K$1 extends Array<string | number>>(obj: T, path: K$1): GetValue<T, K$1> | undefined;
+/**
+ * Get a nested value from an object using dot notation path
+ * @template T - Object type
+ * @template S - Path string literal type
+ * @template D - Default value type
+ * @param obj - Source object
+ * @param path - Dot-separated path string
+ * @param defaultValue - Fallback value if path not found
+ * @returns Value at path or default value
+ *
+ * @example
+ * getObjectValue({a: [{b: 1}]}, 'a.0.b', 2) // 1
+ */
+declare function getObjectValue<T, S extends string, D>(obj: T, path: S, defaultValue: D): Exclude<GetValue<T, SplitPath<S>>, undefined> | D;
+/**
+ * Get a nested value from an object using dot notation path
+ * @template T - Object type
+ * @template S - Path string literal type
+ * @param obj - Source object
+ * @param path - Dot-separated path string
+ * @returns Value at path or undefined
+ *
+ * @example
+ * getObjectValue({a: [{b: 1}]}, 'a.0.b') // 1
+ */
+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 }
+ */
+declare function extendProps<T extends object, P$1 extends object>(base: T, props: P$1): T & P$1;
+//#endregion
+//#region src/functions/poll.d.ts
+/**
+ * Repeatedly polls an async `cond` function UNTIL it returns a TRUTHY value,
+ * or until the operation times out or is aborted.
+ *
+ * Designed for waiting on async jobs, external state, or delayed availability.
+ *
+ * @template T The type of the successful result.
+ *
+ * @param cond
+ * A function returning a Promise that resolves to:
+ *   - a truthy value `T` → stop polling and return it
+ *   - falsy/null/undefined → continue polling
+ *
+ * @param options
+ * Configuration options:
+ * - `interval` (number) — Time between polls in ms (default: 5000 ms)
+ * - `timeout` (number) — Max total duration before failing (default: 5 min)
+ * - `jitter` (boolean) — Add small random offset (±10%) to intervals to avoid sync bursts (default: true)
+ * - `signal` (AbortSignal) — Optional abort signal to cancel polling
+ *
+ * @returns
+ * Resolves with the truthy value `T` when successful.
+ * Throws `AbortError` if aborted
+ *
+ * @example
+ * ```ts
+ * const job = await poll(async () => {
+ *   const status = await getJobStatus();
+ *   return status === 'done' ? status : null;
+ * }, { interval: 3000, timeout: 60000 });
+ * ```
+ */
+declare function poll<T>(cond: () => Promise<T | null | false | undefined>, {
+  interval,
+  timeout,
+  jitter,
+  signal
+}?: Partial<{
+  interval: number;
+  timeout: number;
+  signal: AbortSignal;
+  jitter: boolean;
+}>): Promise<T>;
+//#endregion
+//#region src/functions/schedule.d.ts
+type Task = () => Promise<void> | void;
+interface ScheduleOpts {
+  retry?: number;
+  delay?: number;
+  timeout?: number;
+}
+/**
+ * Runs a function asynchronously in the background.
+ * Returns immediately, retries on failure if configured.
+ * Logs total time taken.
+ */
+declare function schedule(task: Task, options?: ScheduleOpts): void;
+//#endregion
+//#region src/functions/shield.d.ts
+/**
+ * A helper to run sync or async operations safely without try/catch.
+ *
+ * Returns a tuple `[error, data]`:
+ * - `error`: the thrown error (if any), otherwise `null`
+ * - `data`: the resolved value (if successful), otherwise `null`
+ *
+ * @example
+ * ```ts
+ * const [err, value] = shield(() => riskySync());
+ * if (err) console.error(err);
+ *
+ * const [asyncErr, result] = await shield(fetchData());
+ * if (asyncErr) throw asyncErr;
+ * ```
+ */
+declare function shield<T, E = Error>(operation: Promise<T>): Promise<[E | null, T | null]>;
+declare function shield<T, E = Error>(operation: () => T): [E | null, T | null];
+//#endregion
+//#region src/functions/utils.d.ts
+/**
+ * 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.
+ */
+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.
+ */
+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.
+ */
+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.
+ */
+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.
+ */
+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.
+ */
+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
+ */
+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"
+ */
+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
+ */
+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
+ */
+declare const svgToBase64: (str: string) => string;
+/**
+ * Pauses execution for the specified time.
+ *
+ * `signal` allows cancelling the sleep via AbortSignal.
+ *
+ * @param time - Time in milliseconds to sleep (default is 1000ms)
+ * @param signal - Optional AbortSignal to cancel the sleep early
+ * @returns - A Promise that resolves after the specified time or when aborted
+ */
+declare const sleep: (time?: number, signal?: AbortSignal) => Promise<void>;
+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.
+ */
+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.
+ */
+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"
+ * ```
+ */
+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.
+ */
+type MergeRefs = <T>(...refs: Array<React.Ref<T> | undefined>) => React.RefCallback<T>;
+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');
+ */
+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!'
+ */
+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
+ */
+declare function normalizeText(str?: string | null, options?: {
+  lowercase?: boolean;
+  removeAccents?: boolean;
+  removeNonAlphanumeric?: boolean;
+}): string;
+//#endregion
+export { getClientSideCookie as A, schedule as C, hydrate as D, getObjectValue as E, setClientSideCookie as M, deepmerge as O, Task as S, extendProps as T, sleep as _, convertToSlug as a, shield as b, escapeRegExp as c, isNavActive as d, isSSR as f, scrollTo as g, printf as h, convertToNormalCase as i, hasClientSideCookie as j, deleteClientSideCookie as k, goToClientSideHash as l, normalizeText as m, cleanSrc as n, copyToClipboard as o, mergeRefs as p, cn as r, debounce as s, MergeRefs as t, isLinkActive as u, svgToBase64 as v, poll as w, ScheduleOpts as x, throttle as y };

package/dist/index.cjs

@@ -1 +1 @@
-let e=require(`clsx`),t=require(`tailwind-merge`);const n=(e,t,n,r=`/`)=>{let i=``;if(n){let e=new Date;e.setTime(e.getTime()+n*24*60*60*1e3),i=`; expires=${e.toUTCString()}`}document.cookie=`${e}=${t||``}${i}; path=${r}`},r=(e,t=`/`)=>{document.cookie=`${e}=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=${t}`},i=e=>document.cookie.split(`; `).some(t=>t.startsWith(`${e}=`)),a=e=>({value:document.cookie.split(`; `).find(t=>t.startsWith(`${e}=`))?.split(`=`)[1]}),o=e=>!e,s=e=>e==null,c=e=>{if(e==null)return!0;switch(typeof e){case`string`:case`number`:case`bigint`:case`boolean`:case`symbol`:return!0;default:return!1}};function l(e){if(typeof e!=`object`||!e||Object.prototype.toString.call(e)!==`[object Object]`)return!1;let t=Object.getPrototypeOf(e);return t===null||t===Object.prototype}function u(e,...t){let n,r={},i=t[t.length-1];i&&typeof i==`object`&&!Array.isArray(i)&&(i.arrayMerge!==void 0||i.clone!==void 0||i.customMerge!==void 0||i.maxDepth!==void 0)?(r={...r,...i},n=t.slice(0,-1)):n=t;let{arrayMerge:a=`replace`,clone:o=!0,customMerge:s,maxDepth:c=100}=r,u=new WeakMap;return d(e,n,0);function d(e,t,n){if(n>=c)return console.warn(`[deepmerge] Maximum depth ${c} exceeded. Returning target as-is.`),e;if(!l(e)&&!Array.isArray(e)){for(let e of t)if(e!==void 0)return e;return e}let r=o?Array.isArray(e)?[...e]:{...e}:e;for(let e of t)if(e!=null&&!u.has(e))if(u.set(e,r),Array.isArray(r)&&Array.isArray(e))r=f(r,e,a);else if(l(r)&&l(e)){let t=new Set([...Object.keys(r),...Object.keys(e),...Object.getOwnPropertySymbols(r),...Object.getOwnPropertySymbols(e)]);for(let i of t){let t=r[i],o=e[i];s&&s(i,t,o)!==void 0?r[i]=s(i,t,o):l(t)&&l(o)?r[i]=d(t,[o],n+1):Array.isArray(t)&&Array.isArray(o)?r[i]=f(t,o,a):o!==void 0&&(r[i]=o)}}else r=e;return r}function f(e,t,n){if(typeof n==`function`)return n(e,t);switch(n){case`concat`:return[...e,...t];case`merge`:let n=Math.max(e.length,t.length),r=[];for(let i=0;i<n;i++)i<e.length&&i<t.length?l(e[i])&&l(t[i])?r[i]=d(e[i],[t[i]],0):r[i]=t[i]:i<e.length?r[i]=e[i]:r[i]=t[i];return r;case`replace`:default:return[...t]}}}function d(e){return f(e)}function f(e){if(e!==null){if(typeof e!=`object`||!e)return e;if(Array.isArray(e))return e.map(f);if(l(e)){let t={};for(let n in e)t[n]=f(e[n]);return t}return e}}function p(e,t,n){if(typeof t!=`string`&&!Array.isArray(t))return n;let r=(()=>Array.isArray(t)?t:t===``?[]:String(t).split(`.`).filter(e=>e!==``))();if(!Array.isArray(r))return n;let i=e;for(let e of r){if(i==null)return n;let t=typeof e==`string`&&Array.isArray(i)&&/^\d+$/.test(e)?Number.parseInt(e,10):e;i=i[t]}return i===void 0?n:i}function m(e,t){return Object.assign(e,t)}function h(...n){return(0,t.twMerge)((0,e.clsx)(n))}function g(e,t){return console.warn(`isNavActive is deprecated. Use isLinkActive instead.`),RegExp(`^/?${e}(/|$)`).test(t)}function _({path:e,currentPath:t,locales:n=[`en`,`es`,`de`,`zh`,`bn`,`fr`,`it`,`nl`],exact:r=!0}){let i=RegExp(`^/?(${n.join(`|`)})/`),a=e=>e.replace(i,``).replace(/^\/+|\/+$/g,``),o=a(e),s=a(t);return r?o===s:s.startsWith(o)}function v(e){let t=e;return e.includes(`/public/`)&&(t=e.replace(`/public/`,`/`)),t.trim()}const y=(e,t)=>{let n;if(typeof e==`string`)n=document.querySelector(e);else if(e.current)n=e.current;else return;n&&n.scrollTo({top:t===`top`?0:n.scrollHeight-n.clientHeight,behavior:`smooth`})},b=(e,t=()=>{})=>{typeof window>`u`||!navigator.clipboard?.writeText||e&&navigator.clipboard.writeText(e).then(t)};function x(e){return(e.split(`.`).pop()||e).replace(/([a-z])([A-Z])/g,`$1 $2`).split(/[-_|�\s]+/).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(` `)}const S=`àáãäâèéëêìíïîòóöôùúüûñç·/_,:;`,C=`aaaaaeeeeiiiioooouuuunc------`,w=e=>{if(typeof e!=`string`)throw TypeError(`Input must be a string`);let t=e.trim().toLowerCase(),n={};for(let e=0;e<29;e++)n[S.charAt(e)]=`aaaaaeeeeiiiioooouuuunc------`.charAt(e);return t=t.replace(RegExp(`[${S}]`,`g`),e=>n[e]||e),t.replace(/[^a-z0-9 -]/g,``).replace(/\s+/g,`-`).replace(/-+/g,`-`).replace(/^-+/,``).replace(/-+$/,``)||``},T=typeof window>`u`,E=e=>T?Buffer.from(e).toString(`base64`):window.btoa(e),D=(e=1e3,t)=>new Promise(n=>{if(t?.aborted)return n();let r=setTimeout(()=>{a(),n()},e);function i(){clearTimeout(r),a(),n()}function a(){t?.removeEventListener(`abort`,i)}t&&t.addEventListener(`abort`,i,{once:!0})});function O(e,t=100,n){if(typeof e!=`function`)throw TypeError(`Expected the first parameter to be a function, got \`${typeof e}\`.`);if(t<0)throw RangeError("`wait` must not be negative.");let r=n?.immediate??!1,i,a,o,s;function c(){return s=e.apply(o,a),a=void 0,o=void 0,s}let l=function(...e){return a=e,o=this,i===void 0&&r&&(s=c.call(this)),i!==void 0&&clearTimeout(i),i=setTimeout(c.bind(this),t),s};return Object.defineProperty(l,`isPending`,{get(){return i!==void 0}}),l}function k(e,t=100,n){if(typeof e!=`function`)throw TypeError(`Expected the first parameter to be a function, got \`${typeof e}\`.`);if(t<0)throw RangeError("`wait` must not be negative.");let r=n?.leading??!0,i=n?.trailing??!0,a,o,s,c,l;function u(){c=Date.now(),l=e.apply(s,o),o=void 0,s=void 0}function d(){a=void 0,i&&o&&u()}let f=function(...e){let n=c?Date.now()-c:1/0;return o=e,s=this,n>=t?r?u():a=setTimeout(d,t):!a&&i&&(a=setTimeout(d,t-n)),l};return Object.defineProperty(f,`isPending`,{get(){return a!==void 0}}),f}function A(e,...t){let n=t.length===1&&Array.isArray(t[0])?t[0]:t,r=0;return e.replace(/%s/g,()=>{let e=n[r++];return e===void 0?``:String(e)})}const j=(...e)=>t=>{for(let n of e)n&&(typeof n==`function`?n(t):n.current=t)};function M(e,t){let n=document.getElementById(e);n&&(n.scrollIntoView({behavior:`smooth`,block:`start`,...t}),window.history.pushState(null,``,`#${e}`))}function N(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function P(e,t={}){if(!e)return``;let{lowercase:n=!0,removeAccents:r=!0,removeNonAlphanumeric:i=!0}=t,a=e.normalize(`NFC`);return r&&(a=a.normalize(`NFD`).replace(/\p{M}/gu,``)),i&&(a=a.replace(/^[^\p{L}\p{N}]*|[^\p{L}\p{N}]*$/gu,``)),n&&(a=a.toLocaleLowerCase()),a}async function F(e,{interval:t=5e3,timeout:n=300*1e3,jitter:r=!0,signal:i}={}){let a=Date.now(),o=i?.aborted??!1,s=()=>{o=!0};i?.addEventListener(`abort`,s,{once:!0});try{for(let s=0;;s++){if(o)throw Error(`Polling aborted`);let s=await e();if(s)return s;if(Date.now()-a>=n)throw Error(`Polling timed out`,{cause:`Polling timed out after ${n}ms`});await D(r?t+(Math.random()-.5)*t*.2:t,i)}}catch(e){throw e}finally{i?.removeEventListener(`abort`,s)}}function I(e,t={}){let{retry:n=0,delay:r=0}=t,i=Date.now(),a=async t=>{try{await e();let t=Date.now()-i;console.log(`⚡[schedule.ts] Completed in ${t}ms`)}catch(e){if(console.log(`⚡[schedule.ts] err:`,e),t>0)console.log(`⚡[schedule.ts] Retrying in ${r}ms...`),setTimeout(()=>a(t-1),r);else{let e=Date.now()-i;console.log(`⚡[schedule.ts] Failed after ${e}ms`)}}};setTimeout(()=>a(n),0)}function L(e){if(e instanceof Promise)return e.then(e=>[null,e]).catch(e=>[e,null]);try{return[null,e()]}catch(t){return console.log(`\x1b[31m🛡 [shield]\x1b[0m ${e.name} failed →`,t),[t,null]}}exports.cleanSrc=v,exports.cn=h,exports.convertToNormalCase=x,exports.convertToSlug=w,exports.copyToClipboard=b,exports.debounce=O,exports.deepmerge=u,exports.deleteClientSideCookie=r,exports.escapeRegExp=N,exports.extendProps=m,exports.getClientSideCookie=a,exports.getObjectValue=p,exports.goToClientSideHash=M,exports.hasClientSideCookie=i,exports.hydrate=d,exports.isFalsy=o,exports.isLinkActive=_,exports.isNavActive=g,exports.isNullish=s,exports.isPlainObject=l,exports.isPrimitive=c,exports.isSSR=T,exports.mergeRefs=j,exports.normalizeText=P,exports.poll=F,exports.printf=A,exports.schedule=I,exports.scrollTo=y,exports.setClientSideCookie=n,exports.shield=L,exports.sleep=D,exports.svgToBase64=E,exports.throttle=k;
+const e=require(`./functions-BSYagwi9.cjs`);exports.cleanSrc=e.i,exports.cn=e.a,exports.convertToNormalCase=e.o,exports.convertToSlug=e.s,exports.copyToClipboard=e.c,exports.debounce=e.l,exports.deepmerge=e.T,exports.deleteClientSideCookie=e.A,exports.escapeRegExp=e.u,exports.extendProps=e.S,exports.getClientSideCookie=e.j,exports.getObjectValue=e.C,exports.goToClientSideHash=e.d,exports.hasClientSideCookie=e.M,exports.hydrate=e.w,exports.isFalsy=e.E,exports.isLinkActive=e.f,exports.isNavActive=e.p,exports.isNullish=e.D,exports.isPlainObject=e.O,exports.isPrimitive=e.k,exports.isSSR=e.m,exports.mergeRefs=e.h,exports.normalizeText=e.g,exports.poll=e.r,exports.printf=e._,exports.schedule=e.n,exports.scrollTo=e.v,exports.setClientSideCookie=e.N,exports.shield=e.t,exports.sleep=e.y,exports.svgToBase64=e.b,exports.throttle=e.x;

package/dist/index.d.cts

@@ -1,5 +1,6 @@
-import { ClassValue } from "clsx";
+import { n as Task, r as schedule, t as ScheduleOpts } from "./schedule-CRsY0oqG.cjs";
 import * as React from "react";
+import { ClassValue } from "clsx";
 
 //#region src/functions/cookie.d.ts
 declare const setClientSideCookie: (name: string, value: string, days?: number, path?: string) => void;
@@ -213,20 +214,6 @@ declare function poll<T>(cond: () => Promise<T | null | false | undefined>, {
   jitter: boolean;
 }>): Promise<T>;
 //#endregion
-//#region src/functions/schedule.d.ts
-type Task = () => Promise<void> | void;
-interface ScheduleOpts {
-  retry?: number;
-  delay?: number;
-  timeout?: number;
-}
-/**
- * Runs a function asynchronously in the background.
- * Returns immediately, retries on failure if configured.
- * Logs total time taken.
- */
-declare function schedule(task: Task, options?: ScheduleOpts): void;
-//#endregion
 //#region src/functions/shield.d.ts
 /**
  * A helper to run sync or async operations safely without try/catch.