@react-hive/honey-utils 1.6.0 → 1.7.0

package/dist/guards.d.ts

@@ -7,6 +7,35 @@ export declare function assert(condition: any, message: string): asserts conditi
  * @returns `true` if the value is null; otherwise, `false`.
  */
 export declare const isNull: (value: unknown) => value is null;
+/**
+ * Checks if a value is null or undefined.
+ *
+ * @param value - The value to check.
+ *
+ * @returns `true` if the value is `null` or `undefined`, otherwise `false`.
+ */
+export declare const isNil: (value: unknown) => value is null | undefined;
+/**
+ * Checks whether the provided value is considered "empty".
+ *
+ * A value is considered empty if it is:
+ * - `null`
+ * - `undefined`
+ * - `''`
+ *
+ * @param value - The value to check.
+ *
+ * @returns `true` if the value is empty; otherwise, `false`.
+ */
+export declare const isNilOrEmptyString: (value: unknown) => value is null | undefined;
+/**
+ * Checks if a value is neither `null` nor `undefined`.
+ *
+ * @param value - The value to check.
+ *
+ * @returns `true` if the value is defined (not `null` or `undefined`); otherwise, `false`.
+ */
+export declare const isDefined: <T>(value: T) => value is NonNullable<T>;
 /**
  * Checks if a value is a string.
  *
@@ -81,27 +110,6 @@ export declare const isFunction: (value: unknown) => value is Function;
  * @returns `true` if the value is a Promise; otherwise, `false`.
  */
 export declare const isPromise: <T = unknown>(value: unknown) => value is Promise<T>;
-/**
- * Checks if a value is null or undefined.
- *
- * @param value - The value to check.
- *
- * @returns `true` if the value is `null` or `undefined`, otherwise `false`.
- */
-export declare const isNil: (value: unknown) => value is null | undefined;
-/**
- * Checks whether the provided value is considered "empty".
- *
- * A value is considered empty if it is:
- * - `null`
- * - `undefined`
- * - `''`
- *
- * @param value - The value to check.
- *
- * @returns `true` if the value is empty; otherwise, `false`.
- */
-export declare const isNilOrEmptyString: (value: unknown) => value is null | undefined;
 /**
  * Checks if a value is a Date object.
  *

package/dist/index.cjs

@@ -1,2 +1,2 @@
-(()=>{"use strict";var e={d:(t,r)=>{for(var n in r)e.o(r,n)&&!e.o(t,n)&&Object.defineProperty(t,n,{enumerable:!0,get:r[n]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r:e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})}},t={};e.r(t),e.d(t,{assert:()=>i,boolFilter:()=>C,calculateEuclideanDistance:()=>V,calculateMovingSpeed:()=>Z,calculatePercentage:()=>_,camelToDashCase:()=>n,chunk:()=>N,cloneBlob:()=>U,convertBlobToFile:()=>W,delay:()=>q,difference:()=>x,everyAsync:()=>Y,filterAsync:()=>T,findAsync:()=>$,forAsync:()=>B,hashString:()=>s,intersection:()=>E,invokeIfFunction:()=>R,isArray:()=>p,isBool:()=>y,isDate:()=>w,isEmptyArray:()=>g,isEmptyObject:()=>f,isFiniteNumber:()=>P,isFunction:()=>m,isInteger:()=>j,isMap:()=>v,isNil:()=>b,isNilOrEmptyString:()=>d,isNull:()=>o,isNumber:()=>c,isObject:()=>u,isPromise:()=>h,isRegExp:()=>S,isSet:()=>M,isString:()=>l,isSymbol:()=>k,isUndefined:()=>O,isValidDate:()=>A,mapAsync:()=>D,noop:()=>L,parse2DMatrix:()=>K,reduceAsync:()=>I,retry:()=>z,someAsync:()=>X,splitStringIntoWords:()=>a,toKebabCase:()=>r,unique:()=>F});const r=e=>e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").toLowerCase(),n=e=>{const t=e.charAt(0),r=e.slice(1);return t.toLowerCase()+r.replace(/[A-Z]/g,e=>`-${e.toLowerCase()}`)},a=e=>e.split(" ").filter(Boolean),s=e=>{let t=5381;for(let r=0;r<e.length;r++)t=33*t^e.charCodeAt(r);return(t>>>0).toString(36)};function i(e,t){if(!e)throw new Error(t)}const o=e=>null===e,l=e=>"string"==typeof e,c=e=>"number"==typeof e,y=e=>"boolean"==typeof e,u=e=>"object"==typeof e,f=e=>u(e)&&!o(e)&&0===Object.keys(e).length,p=e=>Array.isArray(e),g=e=>p(e)&&0===e.length,m=e=>"function"==typeof e,h=e=>m(e?.then),b=e=>null==e,d=e=>""===e||b(e),w=e=>e instanceof Date,A=e=>w(e)&&!isNaN(e.getTime()),S=e=>e instanceof RegExp,v=e=>e instanceof Map,M=e=>e instanceof Set,k=e=>"symbol"==typeof e,O=e=>void 0===e,P=e=>c(e)&&isFinite(e),j=e=>c(e)&&Number.isInteger(e),C=e=>e.filter(Boolean),F=e=>[...new Set(e)],N=(e,t)=>(i(t>0,"Chunk size must be greater than 0"),Array.from({length:Math.ceil(e.length/t)},(r,n)=>e.slice(n*t,(n+1)*t))),E=(...e)=>{if(0===e.length)return[];if(1===e.length)return[...e[0]];const[t,...r]=e;return F(t).filter(e=>r.every(t=>t.includes(e)))},x=(e,t)=>e.filter(e=>!t.includes(e)),B=async(e,t)=>{const r=[];for(let n=0;n<e.length;n++)r.push(await t(e[n],n,e));return r},D=async(e,t)=>Promise.all(e.map(t)),T=async(e,t)=>{const r=await D(e,async(e,r,n)=>!!await t(e,r,n)&&e);return C(r)},X=async(e,t)=>{for(let r=0;r<e.length;r++)if(await t(e[r],r,e))return!0;return!1},Y=async(e,t)=>{for(let r=0;r<e.length;r++)if(!await t(e[r],r,e))return!1;return!0},I=async(e,t,r)=>{let n=r;for(let r=0;r<e.length;r++)n=await t(n,e[r],r,e);return n},$=async(e,t)=>{for(let r=0;r<e.length;r++)if(await t(e[r],r,e))return e[r];return null},L=()=>{},R=(e,...t)=>"function"==typeof e?e(...t):e,q=e=>new Promise(t=>setTimeout(t,e)),z=(e,{maxAttempts:t=3,delayMs:r=300,backoff:n=!0,onRetry:a}={})=>async(...s)=>{let i;for(let o=1;o<=t;o++)try{return await e(...s)}catch(e){if(i=e,o<t){a?.(o,e);const t=n?r*2**(o-1):r;await q(t)}}throw i},V=(e,t,r,n)=>{const a=r-e,s=n-t;return Math.sqrt(a**2+s**2)},Z=(e,t)=>Math.abs(e/t),_=(e,t)=>e*t/100,K=e=>{const t=window.getComputedStyle(e).getPropertyValue("transform").match(/^matrix\((.+)\)$/);if(!t)return{translateX:0,translateY:0,scaleX:1,scaleY:1,skewX:0,skewY:0};const[r,n,a,s,i,o]=t[1].split(", ").map(parseFloat);return{translateX:i,translateY:o,scaleX:r,scaleY:s,skewX:a,skewY:n}},U=e=>new Blob([e],{type:e.type}),W=(e,t)=>new File([e],t,{type:e.type});module.exports=t})();
+(()=>{"use strict";var e={d:(t,r)=>{for(var n in r)e.o(r,n)&&!e.o(t,n)&&Object.defineProperty(t,n,{enumerable:!0,get:r[n]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r:e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})}},t={};e.r(t),e.d(t,{assert:()=>s,boolFilter:()=>F,calculateEuclideanDistance:()=>K,calculateMovingSpeed:()=>U,calculatePercentage:()=>W,camelToDashCase:()=>n,chunk:()=>D,cloneBlob:()=>H,compose:()=>q,convertBlobToFile:()=>J,delay:()=>Z,difference:()=>x,everyAsync:()=>I,filterAsync:()=>X,findAsync:()=>$,forAsync:()=>B,hashString:()=>i,intersection:()=>E,invokeIfFunction:()=>V,isArray:()=>h,isBool:()=>p,isDate:()=>A,isDefined:()=>u,isEmptyArray:()=>d,isEmptyObject:()=>m,isFiniteNumber:()=>j,isFunction:()=>b,isInteger:()=>C,isMap:()=>M,isNil:()=>l,isNilOrEmptyString:()=>c,isNull:()=>o,isNumber:()=>f,isObject:()=>g,isPromise:()=>w,isRegExp:()=>v,isSet:()=>k,isString:()=>y,isSymbol:()=>O,isUndefined:()=>P,isValidDate:()=>S,mapAsync:()=>T,noop:()=>z,parse2DMatrix:()=>G,pipe:()=>L,reduceAsync:()=>R,retry:()=>_,someAsync:()=>Y,splitStringIntoWords:()=>a,toKebabCase:()=>r,unique:()=>N});const r=e=>e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").toLowerCase(),n=e=>{const t=e.charAt(0),r=e.slice(1);return t.toLowerCase()+r.replace(/[A-Z]/g,e=>`-${e.toLowerCase()}`)},a=e=>e.split(" ").filter(Boolean),i=e=>{let t=5381;for(let r=0;r<e.length;r++)t=33*t^e.charCodeAt(r);return(t>>>0).toString(36)};function s(e,t){if(!e)throw new Error(t)}const o=e=>null===e,l=e=>null==e,c=e=>""===e||l(e),u=e=>null!=e,y=e=>"string"==typeof e,f=e=>"number"==typeof e,p=e=>"boolean"==typeof e,g=e=>"object"==typeof e,m=e=>g(e)&&!o(e)&&0===Object.keys(e).length,h=e=>Array.isArray(e),d=e=>h(e)&&0===e.length,b=e=>"function"==typeof e,w=e=>b(e?.then),A=e=>e instanceof Date,S=e=>A(e)&&!isNaN(e.getTime()),v=e=>e instanceof RegExp,M=e=>e instanceof Map,k=e=>e instanceof Set,O=e=>"symbol"==typeof e,P=e=>void 0===e,j=e=>f(e)&&isFinite(e),C=e=>f(e)&&Number.isInteger(e),F=e=>e.filter(Boolean),N=e=>[...new Set(e)],D=(e,t)=>(s(t>0,"Chunk size must be greater than 0"),Array.from({length:Math.ceil(e.length/t)},(r,n)=>e.slice(n*t,(n+1)*t))),E=(...e)=>{if(0===e.length)return[];if(1===e.length)return[...e[0]];const[t,...r]=e;return N(t).filter(e=>r.every(t=>t.includes(e)))},x=(e,t)=>e.filter(e=>!t.includes(e)),B=async(e,t)=>{const r=[];for(let n=0;n<e.length;n++)r.push(await t(e[n],n,e));return r},T=async(e,t)=>Promise.all(e.map(t)),X=async(e,t)=>{const r=await T(e,async(e,r,n)=>!!await t(e,r,n)&&e);return F(r)},Y=async(e,t)=>{for(let r=0;r<e.length;r++)if(await t(e[r],r,e))return!0;return!1},I=async(e,t)=>{for(let r=0;r<e.length;r++)if(!await t(e[r],r,e))return!1;return!0},R=async(e,t,r)=>{let n=r;for(let r=0;r<e.length;r++)n=await t(n,e[r],r,e);return n},$=async(e,t)=>{for(let r=0;r<e.length;r++)if(await t(e[r],r,e))return e[r];return null},L=(...e)=>t=>e.reduce((e,t)=>t(e),t),q=(...e)=>t=>e.reduceRight((e,t)=>t(e),t),z=()=>{},V=(e,...t)=>"function"==typeof e?e(...t):e,Z=e=>new Promise(t=>setTimeout(t,e)),_=(e,{maxAttempts:t=3,delayMs:r=300,backoff:n=!0,onRetry:a}={})=>async(...i)=>{let s;for(let o=1;o<=t;o++)try{return await e(...i)}catch(e){if(s=e,o<t){a?.(o,e);const t=n?r*2**(o-1):r;await Z(t)}}throw s},K=(e,t,r,n)=>{const a=r-e,i=n-t;return Math.sqrt(a**2+i**2)},U=(e,t)=>Math.abs(e/t),W=(e,t)=>e*t/100,G=e=>{const t=window.getComputedStyle(e).getPropertyValue("transform").match(/^matrix\((.+)\)$/);if(!t)return{translateX:0,translateY:0,scaleX:1,scaleY:1,skewX:0,skewY:0};const[r,n,a,i,s,o]=t[1].split(", ").map(parseFloat);return{translateX:s,translateY:o,scaleX:r,scaleY:i,skewX:a,skewY:n}},H=e=>new Blob([e],{type:e.type}),J=(e,t)=>new File([e],t,{type:e.type});module.exports=t})();
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","mappings":"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","sources":["webpack://@react-hive/honey-utils/webpack/bootstrap","webpack://@react-hive/honey-utils/webpack/runtime/define property getters","webpack://@react-hive/honey-utils/webpack/runtime/hasOwnProperty shorthand","webpack://@react-hive/honey-utils/webpack/runtime/make namespace object","webpack://@react-hive/honey-utils/./src/string.ts","webpack://@react-hive/honey-utils/./src/guards.ts","webpack://@react-hive/honey-utils/./src/array.ts","webpack://@react-hive/honey-utils/./src/function.ts","webpack://@react-hive/honey-utils/./src/math.ts","webpack://@react-hive/honey-utils/./src/dom.ts"],"sourcesContent":["// The require scope\nvar __webpack_require__ = {};\n\n","// define getter functions for harmony exports\n__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n\t\t}\n\t}\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","/**\n * Converts a string to kebab-case format.\n *\n * This function transforms camelCase or PascalCase strings into kebab-case by inserting\n * hyphens between lowercase and uppercase letters, then converting everything to lowercase.\n *\n * @param input - The string to convert to kebab-case.\n *\n * @returns The kebab-case formatted string.\n *\n * @example\n * ```ts\n * toKebabCase('helloWorld'); // → 'hello-world'\n * toKebabCase('HelloWorld'); // → 'hello-world'\n * toKebabCase('hello123World'); // → 'hello123-world'\n * ```\n */\nexport const toKebabCase = (input: string): string =>\n  input.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();\n\n/**\n * Converts a camelCase string to dash-case format.\n *\n * This function transforms camelCase strings into dash-case by inserting\n * hyphens before uppercase letters and converting them to lowercase.\n * The function ensures that no hyphen is added at the start of the output string,\n * even if the input begins with an uppercase letter.\n *\n * @param input - The camelCase string to convert to dash-case.\n *\n * @returns The dash-case formatted string.\n *\n * @example\n * ```ts\n * camelToDashCase('helloWorld'); // → 'hello-world'\n * camelToDashCase('HelloWorld'); // → 'hello-world'\n * camelToDashCase('backgroundColor'); // → 'background-color'\n * ```\n */\nexport const camelToDashCase = (input: string): string => {\n  // First handle the first character separately to avoid adding a hyphen at the start\n  const firstChar = input.charAt(0);\n  const restOfString = input.slice(1);\n  \n  // Convert the first character to lowercase without adding a hyphen\n  const firstCharProcessed = firstChar.toLowerCase();\n  \n  // Process the rest of the string normally, adding hyphens before uppercase letters\n  const restProcessed = restOfString.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);\n  \n  return firstCharProcessed + restProcessed;\n};\n\n/**\n * Splits a string into an array of filtered from redundant spaces words.\n *\n * @param input - The input string to be split.\n *\n * @returns An array of words from the input string.\n */\nexport const splitStringIntoWords = (input: string): string[] => input.split(' ').filter(Boolean);\n\n/**\n * Generates a short, consistent hash string from an input string using a DJB2-inspired algorithm.\n *\n * This function uses a variation of the DJB2 algorithm, which is a simple yet effective hashing algorithm\n * based on bitwise XOR (`^`) and multiplication by 33. It produces a non-negative 32-bit integer,\n * which is then converted to a base-36 string (digits + lowercase letters) to produce a compact output.\n *\n * Useful for:\n * - Generating stable class names in CSS-in-JS libraries.\n * - Producing consistent cache keys.\n * - Quick and lightweight hashing needs where cryptographic security is not required.\n *\n * ⚠️ This is not cryptographically secure and should not be used for hashing passwords or sensitive data.\n *\n * @param input - The input string to hash.\n *\n * @returns A short, base-36 encoded hash string.\n *\n * @example\n * ```ts\n * const className = hashString('background-color: red;');\n * // → 'e4k1z0x'\n * ```\n */\nexport const hashString = (input: string): string => {\n  let hash = 5381;\n\n  for (let i = 0; i < input.length; i++) {\n    hash = (hash * 33) ^ input.charCodeAt(i);\n  }\n\n  return (hash >>> 0).toString(36);\n};\n","export function assert(condition: any, message: string): asserts condition {\n  if (!condition) {\n    throw new Error(message);\n  }\n}\n\n/**\n * Checks if a value is null.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is null; otherwise, `false`.\n */\nexport const isNull = (value: unknown): value is null => value === null;\n\n/**\n * Checks if a value is a string.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a string; otherwise, `false`.\n */\nexport const isString = (value: unknown): value is string => typeof value === 'string';\n\n/**\n * Checks if a value is a number.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a number; otherwise, `false`.\n */\nexport const isNumber = (value: unknown): value is number => typeof value === 'number';\n\n/**\n * Checks if a value is a boolean.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a boolean; otherwise, `false`.\n */\nexport const isBool = (value: unknown): value is boolean => typeof value === 'boolean';\n\n/**\n * Checks if a value is an object.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is an object; otherwise, `false`.\n */\nexport const isObject = (value: unknown): value is object => typeof value === 'object';\n\n/**\n * Checks if a value is an empty object (no own enumerable properties).\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is an empty object; otherwise, `false`.\n */\nexport const isEmptyObject = (value: unknown): value is Record<string, never> =>\n  isObject(value) && !isNull(value) && Object.keys(value).length === 0;\n\n/**\n * Checks if a value is an array.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is an array; otherwise, `false`.\n */\nexport const isArray = (value: unknown): value is unknown[] => Array.isArray(value);\n\n/**\n * Checks if a value is an empty array.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is an empty array; otherwise, `false`.\n */\nexport const isEmptyArray = (value: unknown): value is [] => isArray(value) && value.length === 0;\n\n/**\n * Checks if a value is a function.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a function; otherwise, `false`.\n */\nexport const isFunction = (value: unknown) => typeof value === 'function';\n\n/**\n * Checks if a value is a Promise.\n *\n * @template T - The type of the value that the Promise resolves to.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a Promise; otherwise, `false`.\n */\nexport const isPromise = <T = unknown>(value: unknown): value is Promise<T> =>\n  isFunction((value as Promise<T>)?.then);\n\n/**\n * Checks if a value is null or undefined.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is `null` or `undefined`, otherwise `false`.\n */\nexport const isNil = (value: unknown): value is null | undefined =>\n  value === undefined || value === null;\n\n/**\n * Checks whether the provided value is considered \"empty\".\n *\n * A value is considered empty if it is:\n * - `null`\n * - `undefined`\n * - `''`\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is empty; otherwise, `false`.\n */\nexport const isNilOrEmptyString = (value: unknown): value is null | undefined =>\n  value === '' || isNil(value);\n\n/**\n * Checks if a value is a Date object.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a Date object; otherwise, `false`.\n */\nexport const isDate = (value: unknown): value is Date => value instanceof Date;\n\n/**\n * Checks if a value is a valid Date object (not Invalid Date).\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a valid Date object; otherwise, `false`.\n */\nexport const isValidDate = (value: unknown): value is Date =>\n  isDate(value) && !isNaN(value.getTime());\n\n/**\n * Checks if a value is a RegExp object.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a RegExp object; otherwise, `false`.\n */\nexport const isRegExp = (value: unknown): value is RegExp => value instanceof RegExp;\n\n/**\n * Checks if a value is a Map.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a Map; otherwise, `false`.\n */\nexport const isMap = (value: unknown): value is Map<unknown, unknown> => value instanceof Map;\n\n/**\n * Checks if a value is a Set.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a Set; otherwise, `false`.\n */\nexport const isSet = (value: unknown): value is Set<unknown> => value instanceof Set;\n\n/**\n * Checks if a value is a Symbol.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a Symbol; otherwise, `false`.\n */\nexport const isSymbol = (value: unknown): value is symbol => typeof value === 'symbol';\n\n/**\n * Checks if a value is undefined.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is undefined; otherwise, `false`.\n */\nexport const isUndefined = (value: unknown): value is undefined => value === undefined;\n\n/**\n * Checks if a value is a finite number.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a finite number; otherwise, `false`.\n */\nexport const isFiniteNumber = (value: unknown): value is number =>\n  isNumber(value) && isFinite(value);\n\n/**\n * Checks if a value is an integer.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is an integer; otherwise, `false`.\n */\nexport const isInteger = (value: unknown): value is number =>\n  isNumber(value) && Number.isInteger(value);\n","import { assert } from './guards';\n\n/**\n * Filters out `null`, `undefined`, and other falsy values from an array,\n * returning a typed array of only truthy `Item` values.\n *\n * Useful when working with optional or nullable items that need to be sanitized.\n *\n * @template T - The type of the items in the array.\n *\n * @param array - An array of items that may include `null`, `undefined`, or falsy values.\n *\n * @returns A new array containing only truthy `Item` values.\n */\nexport const boolFilter = <T>(array: (T | false | null | undefined)[]): T[] =>\n  array.filter(Boolean) as T[];\n\n/**\n * Returns a new array with duplicate values removed.\n *\n * Uses Set for efficient duplicate removal while preserving the original order.\n *\n * @template T - The type of the items in the array.\n *\n * @param array - The input array that may contain duplicate values.\n *\n * @returns A new array with only unique values, maintaining the original order.\n *\n * @example\n * ```ts\n * unique([1, 2, 2, 3, 1, 4]); // [1, 2, 3, 4]\n * unique(['a', 'b', 'a', 'c']); // ['a', 'b', 'c']\n * ```\n */\nexport const unique = <T>(array: T[]): T[] => [...new Set(array)];\n\n/**\n * Splits an array into chunks of the specified size.\n *\n * Useful for pagination, batch processing, or creating grid layouts.\n *\n * @template T - The type of the items in the array.\n *\n * @param array - The input array to be chunked.\n * @param size - The size of each chunk. Must be greater than 0.\n *\n * @returns An array of chunks, where each chunk is an array of the specified size\n *          (except possibly the last chunk, which may be smaller).\n *\n * @example\n * ```ts\n * chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]\n * chunk(['a', 'b', 'c', 'd'], 3); // [['a', 'b', 'c'], ['d']]\n * ```\n */\nexport const chunk = <T>(array: T[], size: number): T[][] => {\n  assert(size > 0, 'Chunk size must be greater than 0');\n\n  return Array.from({ length: Math.ceil(array.length / size) }, (_, index) =>\n    array.slice(index * size, (index + 1) * size),\n  );\n};\n\n/**\n * Returns an array containing elements that exist in all provided arrays.\n *\n * @template T - The type of the items in the arrays.\n *\n * @param arrays - Two or more arrays to find common elements from.\n *\n * @returns A new array containing only the elements that exist in all input arrays.\n *\n * @example\n * ```ts\n * intersection([1, 2, 3], [2, 3, 4]); // [2, 3]\n * intersection(['a', 'b', 'c'], ['b', 'c', 'd'], ['b', 'e']); // ['b']\n * ```\n */\nexport const intersection = <T>(...arrays: T[][]): T[] => {\n  if (arrays.length === 0) {\n    return [];\n  }\n\n  if (arrays.length === 1) {\n    return [...arrays[0]];\n  }\n\n  const [first, ...rest] = arrays;\n  const uniqueFirst = unique(first);\n\n  return uniqueFirst.filter(item => rest.every(array => array.includes(item)));\n};\n\n/**\n * Returns elements from the first array that don't exist in the second array.\n *\n * @template T - The type of the items in the arrays.\n *\n * @param array - The source array.\n * @param exclude - The array containing elements to exclude.\n *\n * @returns A new array with elements from the first array that don't exist in the second array.\n *\n * @example\n * ```ts\n * difference([1, 2, 3, 4], [2, 4]); // [1, 3]\n * difference(['a', 'b', 'c'], ['b']); // ['a', 'c']\n * ```\n */\nexport const difference = <T>(array: T[], exclude: T[]): T[] =>\n  array.filter(item => !exclude.includes(item));\n\n/**\n * Asynchronously iterates over an array and executes an async function on each item sequentially,\n * collecting the results.\n *\n * Unlike `Promise.all`, this runs each promise one after another (not in parallel).\n * Useful when order or timing matters (e.g., rate limits, UI updates, animations).\n *\n * @param array - The array of items to iterate over.\n * @param callbackFn - An async function to execute for each item. Must return a value.\n *\n * @returns A promise that resolves with an array of results from each callback call.\n *\n * @example\n * ```ts\n * const results = await forAsync([1, 2, 3], async (item) => {\n *   await delay(100);\n *\n *   return item * 2;\n * });\n *\n * console.log(results); // [2, 4, 6]\n * ```\n */\nexport const forAsync = async <Item, Result>(\n  array: Item[],\n  callbackFn: (item: Item, index: number, array: Item[]) => Promise<Result>,\n): Promise<Result[]> => {\n  const results: Result[] = [];\n\n  for (let i = 0; i < array.length; i++) {\n    results.push(await callbackFn(array[i], i, array));\n  }\n\n  return results;\n};\n\n/**\n * Executes an asynchronous operation on each element of an array and waits for all promises to resolve.\n *\n * @param array - The array of items to operate on.\n * @param callbackFn - The asynchronous operation to perform on each item.\n *\n * @returns A promise that resolves with an array of results after all operations are completed.\n */\nexport const mapAsync = async <Item, Return>(\n  array: Item[],\n  callbackFn: (item: Item, index: number, array: Item[]) => Promise<Return>,\n): Promise<Return[]> => Promise.all(array.map(callbackFn));\n\n/**\n * A generic function that processes an array asynchronously and filters the results\n * based on the provided async condition.\n *\n * @template Item - The type of the items in the array.\n * @template Return - The type of the items returned by the condition.\n *\n * @param array - An array of items to be processed.\n * @param callbackFn - An async function that returns a condition for each item.\n *\n * @returns A Promise that resolves to an array of items that match the condition.\n */\nexport const filterAsync = async <Item>(\n  array: Item[],\n  callbackFn: (item: Item, index: number, array: Item[]) => Promise<boolean>,\n): Promise<Item[]> => {\n  const results = await mapAsync(array, async (item, index, array) =>\n    (await callbackFn(item, index, array)) ? item : false,\n  );\n\n  return boolFilter(results);\n};\n\n/**\n * Asynchronously checks if at least one element in the array satisfies the async condition.\n *\n * @param array - The array of items to check.\n * @param callbackFn - An async function that returns a boolean.\n *\n * @returns A promise that resolves to true if any item passes the condition.\n */\nexport const someAsync = async <Item>(\n  array: Item[],\n  callbackFn: (item: Item, index: number, array: Item[]) => Promise<boolean>,\n): Promise<boolean> => {\n  for (let i = 0; i < array.length; i++) {\n    if (await callbackFn(array[i], i, array)) {\n      return true;\n    }\n  }\n\n  return false;\n};\n\n/**\n * Asynchronously checks if all elements in the array satisfy the async condition.\n *\n * @param array - The array of items to check.\n * @param callbackFn - An async function that returns a boolean.\n *\n * @returns A promise that resolves to true if all items pass the condition.\n */\nexport const everyAsync = async <Item>(\n  array: Item[],\n  callbackFn: (item: Item, index: number, array: Item[]) => Promise<boolean>,\n): Promise<boolean> => {\n  for (let i = 0; i < array.length; i++) {\n    if (!(await callbackFn(array[i], i, array))) {\n      return false;\n    }\n  }\n\n  return true;\n};\n\n/**\n * Asynchronously reduces an array to a single accumulated value.\n *\n * @template Item - The type of items in the array.\n * @template Accumulator - The type of the accumulated result.\n *\n * @param array - The array to reduce.\n * @param callbackFn - The async reducer function that processes each item and returns the updated accumulator.\n * @param initialValue - The initial accumulator value.\n *\n * @returns A promise that resolves to the final accumulated result.\n */\nexport const reduceAsync = async <Item, Accumulator>(\n  array: Item[],\n  callbackFn: (\n    accumulator: Accumulator,\n    item: Item,\n    index: number,\n    array: Item[],\n  ) => Promise<Accumulator>,\n  initialValue: Accumulator,\n): Promise<Accumulator> => {\n  let accumulator = initialValue;\n\n  for (let i = 0; i < array.length; i++) {\n    accumulator = await callbackFn(accumulator, array[i], i, array);\n  }\n\n  return accumulator;\n};\n\n/**\n * Asynchronously finds the first element that satisfies the async condition.\n *\n * @param array - The array of items to search.\n * @param callbackFn - An async function that returns a boolean.\n *\n * @returns A promise that resolves to the found item or null if none match.\n */\nexport const findAsync = async <Item>(\n  array: Item[],\n  callbackFn: (item: Item, index: number, array: Item[]) => Promise<boolean>,\n): Promise<Item | null> => {\n  for (let i = 0; i < array.length; i++) {\n    if (await callbackFn(array[i], i, array)) {\n      return array[i];\n    }\n  }\n\n  return null;\n};\n","export const noop = () => {};\n\n/**\n * Invokes the given input if it is a function, passing the provided arguments.\n * Otherwise, returns the input as-is.\n *\n * @template Args - Tuple of argument types to pass to the function.\n * @template Result - Return type of the function or the value.\n *\n * @param input - A function to invoke with `args`, or a direct value of type `Result`.\n * @param args - Arguments to pass if `input` is a function.\n *\n * @returns The result of invoking the function, or the original value if it's not a function.\n */\nexport const invokeIfFunction = <Args extends unknown[], Result>(\n  input: ((...args: Args) => Result) | Result,\n  ...args: Args\n): Result => (typeof input === 'function' ? (input as (...args: Args) => Result)(...args) : input);\n\n/**\n * Creates a promise that resolves after the specified delay.\n *\n * Useful for creating artificial delays, implementing timeouts, or spacing operations.\n *\n * @param delayMs - The delay in milliseconds.\n *\n * @returns A promise that resolves after the specified delay.\n *\n * @example\n * ```ts\n * // Wait for 1 second\n * await delay(1000);\n * console.log('This logs after 1 second');\n *\n * // Use with other async operations\n * async function fetchWithTimeout() {\n *   const timeoutPromise = delay(5000).then(() => {\n *     throw new Error('Request timed out');\n *   });\n *\n *   return Promise.race([fetchData(), timeoutPromise]);\n * }\n * ```\n */\nexport const delay = (delayMs: number): Promise<void> =>\n  new Promise(resolve => setTimeout(resolve, delayMs));\n\ninterface RetryOptions {\n  /**\n   * Maximum number of retry attempts before failing.\n   *\n   * @default 3\n   */\n  maxAttempts?: number;\n  /**\n   * Delay in milliseconds between retry attempts.\n   * If `backoff` is true, this is the base delay for exponential backoff.\n   *\n   * @default 300\n   */\n  delayMs?: number;\n  /**\n   * Whether to use exponential backoff for delays between attempts.\n   * When enabled, the delay is multiplied by 2 ^ (`attempt` - 1).\n   *\n   * @default true\n   */\n  backoff?: boolean;\n  /**\n   * Optional callback triggered before each retry attempt.\n   *\n   * @param attempt - The current attempt number (starting from 1).\n   * @param error - The error that caused the retry.\n   */\n  onRetry?: (attempt: number, error: unknown) => void;\n}\n\n/**\n * Wraps an asynchronous function with retry logic.\n *\n * The returned function will attempt to call the original function up to `maxAttempts` times,\n * with a delay between retries. If all attempts fail, the last encountered error is thrown.\n *\n * Useful for operations that may fail intermittently, such as network requests.\n *\n * @template Task - The type of the async function to wrap.\n * @template TaskResult - The result type of the async function.\n *\n * @param task - The async function to wrap with retry logic.\n * @param options - Configuration options for retry behavior.\n *\n * @returns A function that wraps the original function with retry support.\n *\n * @example\n * ```ts\n * async function fetchData() {\n *   const response = await fetch('/api/data');\n *\n *   if (!response.ok) {\n *    throw new Error('Network error');\n *   }\n *\n *   return await response.json();\n * }\n *\n * const fetchWithRetry = retry(fetchData, {\n *   maxAttempts: 5,\n *   delayMs: 500,\n *   onRetry: (attempt, error) => {\n *     console.warn(`Attempt ${attempt} failed:`, error);\n *   }\n * });\n *\n * fetchWithRetry()\n *   .then(data => console.log('Success:', data))\n *   .catch(error => console.error('Failed after retries:', error));\n * ```\n */\nexport const retry = <Task extends (...args: unknown[]) => Promise<TaskResult>, TaskResult>(\n  task: Task,\n  { maxAttempts = 3, delayMs = 300, backoff = true, onRetry }: RetryOptions = {},\n): ((...args: Parameters<Task>) => Promise<TaskResult>) => {\n  return async (...args: Parameters<Task>): Promise<TaskResult> => {\n    let lastError: unknown;\n\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        return await task(...args);\n      } catch (e) {\n        lastError = e;\n\n        if (attempt < maxAttempts) {\n          onRetry?.(attempt, e);\n\n          const delayTime = backoff ? delayMs * 2 ** (attempt - 1) : delayMs;\n          await delay(delayTime);\n        }\n      }\n    }\n\n    throw lastError;\n  };\n};\n","/**\n * Calculates the Euclidean distance between two points in 2D space.\n *\n * @param startX - The X coordinate of the starting point.\n * @param startY - The Y coordinate of the starting point.\n * @param endX - The X coordinate of the ending point.\n * @param endY - The Y coordinate of the ending point.\n *\n * @returns The Euclidean distance between the two points.\n */\nexport const calculateEuclideanDistance = (\n  startX: number,\n  startY: number,\n  endX: number,\n  endY: number,\n): number => {\n  const deltaX = endX - startX;\n  const deltaY = endY - startY;\n\n  return Math.sqrt(deltaX ** 2 + deltaY ** 2);\n};\n\n/**\n * Calculates the moving speed.\n *\n * @param delta - The change in position (distance).\n * @param elapsedTime - The time taken to move the distance.\n *\n * @returns The calculated speed, which is the absolute value of delta divided by elapsed time.\n */\nexport const calculateMovingSpeed = (delta: number, elapsedTime: number): number =>\n  Math.abs(delta / elapsedTime);\n\n/**\n * Calculates the specified percentage of a given value.\n *\n * @param value - The value to calculate the percentage of.\n * @param percentage - The percentage to calculate.\n *\n * @returns The calculated percentage of the value.\n */\nexport const calculatePercentage = (value: number, percentage: number): number => {\n  return (value * percentage) / 100;\n};\n","interface HTMLElementTransformationValues {\n  translateX: number;\n  translateY: number;\n  scaleX: number;\n  scaleY: number;\n  skewX: number;\n  skewY: number;\n}\n\n/**\n * Extracts transformation values (translate, scale, skew) from the 2D transformation matrix of a given HTML element.\n *\n * Only works with 2D transforms (i.e., `matrix(a, b, c, d, e, f)`).\n *\n * @param element - The element with a CSS transform applied.\n * @returns An object with parsed transformation values.\n *\n * @example\n * ```ts\n * const values = parse2DMatrix(myElement);\n * console.log(values.translateX);\n * console.log(values.scaleX);\n * ```\n */\nexport const parse2DMatrix = (element: HTMLElement): HTMLElementTransformationValues => {\n  const computedStyles = window.getComputedStyle(element);\n  const transformValue = computedStyles.getPropertyValue('transform');\n\n  const matrixMatch = transformValue.match(/^matrix\\((.+)\\)$/);\n  if (!matrixMatch) {\n    return {\n      translateX: 0,\n      translateY: 0,\n      scaleX: 1,\n      scaleY: 1,\n      skewX: 0,\n      skewY: 0,\n    };\n  }\n\n  const [scaleX, skewY, skewX, scaleY, translateX, translateY] = matrixMatch[1]\n    .split(', ')\n    .map(parseFloat);\n\n  return {\n    translateX,\n    translateY,\n    scaleX,\n    scaleY,\n    skewX,\n    skewY,\n  };\n};\n\n/**\n * Creates a clone of a Blob object.\n *\n * @param blob - The Blob object to clone.\n *\n * @returns A new Blob with the same content and type as the original.\n */\nexport const cloneBlob = (blob: Blob): Blob => new Blob([blob], { type: blob.type });\n\n/**\n * Converts a `Blob` object into a `File` object with the specified name.\n *\n * This is useful when you receive a `Blob` (e.g., from canvas, fetch, or file manipulation)\n * and need to convert it into a `File` to upload via `FormData` or file inputs.\n *\n * @param blob - The `Blob` to convert.\n * @param fileName - The desired name for the resulting file (including extension).\n *\n * @returns A `File` instance with the same content and MIME type as the input `Blob`.\n *\n * @example\n * ```ts\n * const blob = new Blob(['Hello world'], { type: 'text/plain' });\n * const file = convertBlobToFile(blob, 'hello.txt');\n *\n * console.log(file instanceof File); // true\n * ```\n */\nexport const convertBlobToFile = (blob: Blob, fileName: string): File =>\n  new File([blob], fileName, {\n    type: blob.type,\n  });\n"],"names":["__webpack_require__","exports","definition","key","o","Object","defineProperty","enumerable","get","obj","prop","prototype","hasOwnProperty","call","Symbol","toStringTag","value","toKebabCase","input","replace","toLowerCase","camelToDashCase","firstChar","charAt","restOfString","slice","letter","splitStringIntoWords","split","filter","Boolean","hashString","hash","i","length","charCodeAt","toString","assert","condition","message","Error","isNull","isString","isNumber","isBool","isObject","isEmptyObject","keys","isArray","Array","isEmptyArray","isFunction","isPromise","then","isNil","isNilOrEmptyString","isDate","Date","isValidDate","isNaN","getTime","isRegExp","RegExp","isMap","Map","isSet","Set","isSymbol","isUndefined","undefined","isFiniteNumber","isFinite","isInteger","Number","boolFilter","array","unique","chunk","size","from","Math","ceil","_","index","intersection","arrays","first","rest","item","every","includes","difference","exclude","forAsync","async","callbackFn","results","push","mapAsync","Promise","all","map","filterAsync","someAsync","everyAsync","reduceAsync","initialValue","accumulator","findAsync","noop","invokeIfFunction","args","delay","delayMs","resolve","setTimeout","retry","task","maxAttempts","backoff","onRetry","lastError","attempt","e","delayTime","calculateEuclideanDistance","startX","startY","endX","endY","deltaX","deltaY","sqrt","calculateMovingSpeed","delta","elapsedTime","abs","calculatePercentage","percentage","parse2DMatrix","element","matrixMatch","window","getComputedStyle","getPropertyValue","match","translateX","translateY","scaleX","scaleY","skewX","skewY","parseFloat","cloneBlob","blob","Blob","type","convertBlobToFile","fileName","File"],"sourceRoot":""}
+{"version":3,"file":"index.cjs","mappings":"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","sources":["webpack://@react-hive/honey-utils/webpack/bootstrap","webpack://@react-hive/honey-utils/webpack/runtime/define property getters","webpack://@react-hive/honey-utils/webpack/runtime/hasOwnProperty shorthand","webpack://@react-hive/honey-utils/webpack/runtime/make namespace object","webpack://@react-hive/honey-utils/./src/string.ts","webpack://@react-hive/honey-utils/./src/guards.ts","webpack://@react-hive/honey-utils/./src/array.ts","webpack://@react-hive/honey-utils/./src/function.ts","webpack://@react-hive/honey-utils/./src/math.ts","webpack://@react-hive/honey-utils/./src/dom.ts"],"sourcesContent":["// The require scope\nvar __webpack_require__ = {};\n\n","// define getter functions for harmony exports\n__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n\t\t}\n\t}\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","/**\n * Converts a string to kebab-case format.\n *\n * This function transforms camelCase or PascalCase strings into kebab-case by inserting\n * hyphens between lowercase and uppercase letters, then converting everything to lowercase.\n *\n * @param input - The string to convert to kebab-case.\n *\n * @returns The kebab-case formatted string.\n *\n * @example\n * ```ts\n * toKebabCase('helloWorld'); // → 'hello-world'\n * toKebabCase('HelloWorld'); // → 'hello-world'\n * toKebabCase('hello123World'); // → 'hello123-world'\n * ```\n */\nexport const toKebabCase = (input: string): string =>\n  input.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();\n\n/**\n * Converts a camelCase string to dash-case format.\n *\n * This function transforms camelCase strings into dash-case by inserting\n * hyphens before uppercase letters and converting them to lowercase.\n * The function ensures that no hyphen is added at the start of the output string,\n * even if the input begins with an uppercase letter.\n *\n * @param input - The camelCase string to convert to dash-case.\n *\n * @returns The dash-case formatted string.\n *\n * @example\n * ```ts\n * camelToDashCase('helloWorld'); // → 'hello-world'\n * camelToDashCase('HelloWorld'); // → 'hello-world'\n * camelToDashCase('backgroundColor'); // → 'background-color'\n * ```\n */\nexport const camelToDashCase = (input: string): string => {\n  // First handle the first character separately to avoid adding a hyphen at the start\n  const firstChar = input.charAt(0);\n  const restOfString = input.slice(1);\n  \n  // Convert the first character to lowercase without adding a hyphen\n  const firstCharProcessed = firstChar.toLowerCase();\n  \n  // Process the rest of the string normally, adding hyphens before uppercase letters\n  const restProcessed = restOfString.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);\n  \n  return firstCharProcessed + restProcessed;\n};\n\n/**\n * Splits a string into an array of filtered from redundant spaces words.\n *\n * @param input - The input string to be split.\n *\n * @returns An array of words from the input string.\n */\nexport const splitStringIntoWords = (input: string): string[] => input.split(' ').filter(Boolean);\n\n/**\n * Generates a short, consistent hash string from an input string using a DJB2-inspired algorithm.\n *\n * This function uses a variation of the DJB2 algorithm, which is a simple yet effective hashing algorithm\n * based on bitwise XOR (`^`) and multiplication by 33. It produces a non-negative 32-bit integer,\n * which is then converted to a base-36 string (digits + lowercase letters) to produce a compact output.\n *\n * Useful for:\n * - Generating stable class names in CSS-in-JS libraries.\n * - Producing consistent cache keys.\n * - Quick and lightweight hashing needs where cryptographic security is not required.\n *\n * ⚠️ This is not cryptographically secure and should not be used for hashing passwords or sensitive data.\n *\n * @param input - The input string to hash.\n *\n * @returns A short, base-36 encoded hash string.\n *\n * @example\n * ```ts\n * const className = hashString('background-color: red;');\n * // → 'e4k1z0x'\n * ```\n */\nexport const hashString = (input: string): string => {\n  let hash = 5381;\n\n  for (let i = 0; i < input.length; i++) {\n    hash = (hash * 33) ^ input.charCodeAt(i);\n  }\n\n  return (hash >>> 0).toString(36);\n};\n","export function assert(condition: any, message: string): asserts condition {\n  if (!condition) {\n    throw new Error(message);\n  }\n}\n\n/**\n * Checks if a value is null.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is null; otherwise, `false`.\n */\nexport const isNull = (value: unknown): value is null => value === null;\n\n/**\n * Checks if a value is null or undefined.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is `null` or `undefined`, otherwise `false`.\n */\nexport const isNil = (value: unknown): value is null | undefined =>\n  value === undefined || value === null;\n\n/**\n * Checks whether the provided value is considered \"empty\".\n *\n * A value is considered empty if it is:\n * - `null`\n * - `undefined`\n * - `''`\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is empty; otherwise, `false`.\n */\nexport const isNilOrEmptyString = (value: unknown): value is null | undefined =>\n  value === '' || isNil(value);\n\n/**\n * Checks if a value is neither `null` nor `undefined`.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is defined (not `null` or `undefined`); otherwise, `false`.\n */\nexport const isDefined = <T>(value: T): value is NonNullable<T> =>\n  value !== null && value !== undefined;\n\n/**\n * Checks if a value is a string.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a string; otherwise, `false`.\n */\nexport const isString = (value: unknown): value is string => typeof value === 'string';\n\n/**\n * Checks if a value is a number.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a number; otherwise, `false`.\n */\nexport const isNumber = (value: unknown): value is number => typeof value === 'number';\n\n/**\n * Checks if a value is a boolean.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a boolean; otherwise, `false`.\n */\nexport const isBool = (value: unknown): value is boolean => typeof value === 'boolean';\n\n/**\n * Checks if a value is an object.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is an object; otherwise, `false`.\n */\nexport const isObject = (value: unknown): value is object => typeof value === 'object';\n\n/**\n * Checks if a value is an empty object (no own enumerable properties).\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is an empty object; otherwise, `false`.\n */\nexport const isEmptyObject = (value: unknown): value is Record<string, never> =>\n  isObject(value) && !isNull(value) && Object.keys(value).length === 0;\n\n/**\n * Checks if a value is an array.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is an array; otherwise, `false`.\n */\nexport const isArray = (value: unknown): value is unknown[] => Array.isArray(value);\n\n/**\n * Checks if a value is an empty array.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is an empty array; otherwise, `false`.\n */\nexport const isEmptyArray = (value: unknown): value is [] => isArray(value) && value.length === 0;\n\n/**\n * Checks if a value is a function.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a function; otherwise, `false`.\n */\nexport const isFunction = (value: unknown) => typeof value === 'function';\n\n/**\n * Checks if a value is a Promise.\n *\n * @template T - The type of the value that the Promise resolves to.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a Promise; otherwise, `false`.\n */\nexport const isPromise = <T = unknown>(value: unknown): value is Promise<T> =>\n  isFunction((value as Promise<T>)?.then);\n\n/**\n * Checks if a value is a Date object.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a Date object; otherwise, `false`.\n */\nexport const isDate = (value: unknown): value is Date => value instanceof Date;\n\n/**\n * Checks if a value is a valid Date object (not Invalid Date).\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a valid Date object; otherwise, `false`.\n */\nexport const isValidDate = (value: unknown): value is Date =>\n  isDate(value) && !isNaN(value.getTime());\n\n/**\n * Checks if a value is a RegExp object.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a RegExp object; otherwise, `false`.\n */\nexport const isRegExp = (value: unknown): value is RegExp => value instanceof RegExp;\n\n/**\n * Checks if a value is a Map.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a Map; otherwise, `false`.\n */\nexport const isMap = (value: unknown): value is Map<unknown, unknown> => value instanceof Map;\n\n/**\n * Checks if a value is a Set.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a Set; otherwise, `false`.\n */\nexport const isSet = (value: unknown): value is Set<unknown> => value instanceof Set;\n\n/**\n * Checks if a value is a Symbol.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a Symbol; otherwise, `false`.\n */\nexport const isSymbol = (value: unknown): value is symbol => typeof value === 'symbol';\n\n/**\n * Checks if a value is undefined.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is undefined; otherwise, `false`.\n */\nexport const isUndefined = (value: unknown): value is undefined => value === undefined;\n\n/**\n * Checks if a value is a finite number.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is a finite number; otherwise, `false`.\n */\nexport const isFiniteNumber = (value: unknown): value is number =>\n  isNumber(value) && isFinite(value);\n\n/**\n * Checks if a value is an integer.\n *\n * @param value - The value to check.\n *\n * @returns `true` if the value is an integer; otherwise, `false`.\n */\nexport const isInteger = (value: unknown): value is number =>\n  isNumber(value) && Number.isInteger(value);\n","import { assert } from './guards';\n\n/**\n * Filters out `null`, `undefined`, and other falsy values from an array,\n * returning a typed array of only truthy `Item` values.\n *\n * Useful when working with optional or nullable items that need to be sanitized.\n *\n * @template T - The type of the items in the array.\n *\n * @param array - An array of items that may include `null`, `undefined`, or falsy values.\n *\n * @returns A new array containing only truthy `Item` values.\n */\nexport const boolFilter = <T>(array: (T | false | null | undefined)[]): T[] =>\n  array.filter(Boolean) as T[];\n\n/**\n * Returns a new array with duplicate values removed.\n *\n * Uses Set for efficient duplicate removal while preserving the original order.\n *\n * @template T - The type of the items in the array.\n *\n * @param array - The input array that may contain duplicate values.\n *\n * @returns A new array with only unique values, maintaining the original order.\n *\n * @example\n * ```ts\n * unique([1, 2, 2, 3, 1, 4]); // [1, 2, 3, 4]\n * unique(['a', 'b', 'a', 'c']); // ['a', 'b', 'c']\n * ```\n */\nexport const unique = <T>(array: T[]): T[] => [...new Set(array)];\n\n/**\n * Splits an array into chunks of the specified size.\n *\n * Useful for pagination, batch processing, or creating grid layouts.\n *\n * @template T - The type of the items in the array.\n *\n * @param array - The input array to be chunked.\n * @param size - The size of each chunk. Must be greater than 0.\n *\n * @returns An array of chunks, where each chunk is an array of the specified size\n *          (except possibly the last chunk, which may be smaller).\n *\n * @example\n * ```ts\n * chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]\n * chunk(['a', 'b', 'c', 'd'], 3); // [['a', 'b', 'c'], ['d']]\n * ```\n */\nexport const chunk = <T>(array: T[], size: number): T[][] => {\n  assert(size > 0, 'Chunk size must be greater than 0');\n\n  return Array.from({ length: Math.ceil(array.length / size) }, (_, index) =>\n    array.slice(index * size, (index + 1) * size),\n  );\n};\n\n/**\n * Returns an array containing elements that exist in all provided arrays.\n *\n * @template T - The type of the items in the arrays.\n *\n * @param arrays - Two or more arrays to find common elements from.\n *\n * @returns A new array containing only the elements that exist in all input arrays.\n *\n * @example\n * ```ts\n * intersection([1, 2, 3], [2, 3, 4]); // [2, 3]\n * intersection(['a', 'b', 'c'], ['b', 'c', 'd'], ['b', 'e']); // ['b']\n * ```\n */\nexport const intersection = <T>(...arrays: T[][]): T[] => {\n  if (arrays.length === 0) {\n    return [];\n  }\n\n  if (arrays.length === 1) {\n    return [...arrays[0]];\n  }\n\n  const [first, ...rest] = arrays;\n  const uniqueFirst = unique(first);\n\n  return uniqueFirst.filter(item => rest.every(array => array.includes(item)));\n};\n\n/**\n * Returns elements from the first array that don't exist in the second array.\n *\n * @template T - The type of the items in the arrays.\n *\n * @param array - The source array.\n * @param exclude - The array containing elements to exclude.\n *\n * @returns A new array with elements from the first array that don't exist in the second array.\n *\n * @example\n * ```ts\n * difference([1, 2, 3, 4], [2, 4]); // [1, 3]\n * difference(['a', 'b', 'c'], ['b']); // ['a', 'c']\n * ```\n */\nexport const difference = <T>(array: T[], exclude: T[]): T[] =>\n  array.filter(item => !exclude.includes(item));\n\n/**\n * Asynchronously iterates over an array and executes an async function on each item sequentially,\n * collecting the results.\n *\n * Unlike `Promise.all`, this runs each promise one after another (not in parallel).\n * Useful when order or timing matters (e.g., rate limits, UI updates, animations).\n *\n * @param array - The array of items to iterate over.\n * @param predicate - An async function to execute for each item. Must return a value.\n *\n * @returns A promise that resolves with an array of results from each predicate call.\n *\n * @example\n * ```ts\n * const results = await forAsync([1, 2, 3], async (item) => {\n *   await delay(100);\n *\n *   return item * 2;\n * });\n *\n * console.log(results); // [2, 4, 6]\n * ```\n */\nexport const forAsync = async <Item, Result>(\n  array: Item[],\n  predicate: (item: Item, index: number, array: Item[]) => Promise<Result>,\n): Promise<Result[]> => {\n  const results: Result[] = [];\n\n  for (let i = 0; i < array.length; i++) {\n    results.push(await predicate(array[i], i, array));\n  }\n\n  return results;\n};\n\n/**\n * Executes an asynchronous operation on each element of an array and waits for all promises to resolve.\n *\n * @param array - The array of items to operate on.\n * @param predicate - The asynchronous operation to perform on each item.\n *\n * @returns A promise that resolves with an array of results after all operations are completed.\n */\nexport const mapAsync = async <Item, Return>(\n  array: Item[],\n  predicate: (item: Item, index: number, array: Item[]) => Promise<Return>,\n): Promise<Return[]> => Promise.all(array.map(predicate));\n\n/**\n * A generic function that processes an array asynchronously and filters the results\n * based on the provided async condition.\n *\n * @template Item - The type of the items in the array.\n * @template Return - The type of the items returned by the condition.\n *\n * @param array - An array of items to be processed.\n * @param predicate - An async function that returns a condition for each item.\n *\n * @returns A Promise that resolves to an array of items that match the condition.\n */\nexport const filterAsync = async <Item>(\n  array: Item[],\n  predicate: (item: Item, index: number, array: Item[]) => Promise<boolean>,\n): Promise<Item[]> => {\n  const results = await mapAsync(array, async (item, index, array) =>\n    (await predicate(item, index, array)) ? item : false,\n  );\n\n  return boolFilter(results);\n};\n\n/**\n * Asynchronously checks if at least one element in the array satisfies the async condition.\n *\n * @param array - The array of items to check.\n * @param predicate - An async function that returns a boolean.\n *\n * @returns A promise that resolves to true if any item passes the condition.\n */\nexport const someAsync = async <Item>(\n  array: Item[],\n  predicate: (item: Item, index: number, array: Item[]) => Promise<boolean>,\n): Promise<boolean> => {\n  for (let i = 0; i < array.length; i++) {\n    if (await predicate(array[i], i, array)) {\n      return true;\n    }\n  }\n\n  return false;\n};\n\n/**\n * Asynchronously checks if all elements in the array satisfy the async condition.\n *\n * @param array - The array of items to check.\n * @param predicate - An async function that returns a boolean.\n *\n * @returns A promise that resolves to true if all items pass the condition.\n */\nexport const everyAsync = async <Item>(\n  array: Item[],\n  predicate: (item: Item, index: number, array: Item[]) => Promise<boolean>,\n): Promise<boolean> => {\n  for (let i = 0; i < array.length; i++) {\n    if (!(await predicate(array[i], i, array))) {\n      return false;\n    }\n  }\n\n  return true;\n};\n\n/**\n * Asynchronously reduces an array to a single accumulated value.\n *\n * @template Item - The type of items in the array.\n * @template Accumulator - The type of the accumulated result.\n *\n * @param array - The array to reduce.\n * @param predicate - The async reducer function that processes each item and returns the updated accumulator.\n * @param initialValue - The initial accumulator value.\n *\n * @returns A promise that resolves to the final accumulated result.\n */\nexport const reduceAsync = async <Item, Accumulator>(\n  array: Item[],\n  predicate: (\n    accumulator: Accumulator,\n    item: Item,\n    index: number,\n    array: Item[],\n  ) => Promise<Accumulator>,\n  initialValue: Accumulator,\n): Promise<Accumulator> => {\n  let accumulator = initialValue;\n\n  for (let i = 0; i < array.length; i++) {\n    accumulator = await predicate(accumulator, array[i], i, array);\n  }\n\n  return accumulator;\n};\n\n/**\n * Asynchronously finds the first element that satisfies the async condition.\n *\n * @param array - The array of items to search.\n * @param predicate - An async function that returns a boolean.\n *\n * @returns A promise that resolves to the found item or null if none match.\n */\nexport const findAsync = async <Item>(\n  array: Item[],\n  predicate: (item: Item, index: number, array: Item[]) => Promise<boolean>,\n): Promise<Item | null> => {\n  for (let i = 0; i < array.length; i++) {\n    if (await predicate(array[i], i, array)) {\n      return array[i];\n    }\n  }\n\n  return null;\n};\n\ntype PipeFn = (arg: unknown) => unknown;\n\ntype Pipe = {\n  <A, B>(fn1: (a: A) => B): (a: A) => B;\n  <A, B, C>(fn1: (a: A) => B, fn2: (b: B) => C): (a: A) => C;\n  <A, B, C, D>(fn1: (a: A) => B, fn2: (b: B) => C, fn3: (c: C) => D): (a: A) => D;\n  <A, B, C, D, E>(\n    fn1: (a: A) => B,\n    fn2: (b: B) => C,\n    fn3: (c: C) => D,\n    fn4: (d: D) => E,\n  ): (a: A) => E;\n  <A, B, C, D, E, F>(\n    fn1: (a: A) => B,\n    fn2: (b: B) => C,\n    fn3: (c: C) => D,\n    fn4: (d: D) => E,\n    fn5: (e: E) => F,\n  ): (a: A) => F;\n  (...fns: PipeFn[]): (arg: unknown) => unknown;\n};\n\n/**\n * Composes multiple unary functions into a single function, applying them from left to right.\n *\n * Useful for building a data processing pipeline where the output of one function becomes the input of the next.\n *\n * Types are inferred up to 5 chained functions for full type safety. Beyond that, it falls back to the unknown.\n *\n * @param fns - A list of unary functions to compose.\n *\n * @returns A new function that applies all functions from left to right.\n *\n * @example\n * ```ts\n * const add = (x: number) => x + 1;\n * const double = (x: number) => x * 2;\n * const toStr = (x: number) => `Result: ${x}`;\n *\n * const result = pipe(add, double, toStr)(2);\n * // => 'Result: 6'\n * ```\n */\nexport const pipe: Pipe =\n  (...fns: PipeFn[]) =>\n  (arg: unknown) =>\n    fns.reduce((prev, fn) => fn(prev), arg);\n\ntype ComposeFn = (arg: unknown) => unknown;\n\ntype Compose = {\n  <A, R>(fn1: (a: A) => R): (a: A) => R;\n  <A, B, R>(fn1: (b: B) => R, fn2: (a: A) => B): (a: A) => R;\n  <A, B, C, R>(fn1: (c: C) => R, fn2: (b: B) => C, fn3: (a: A) => B): (a: A) => R;\n  <A, B, C, D, R>(\n    fn1: (d: D) => R,\n    fn2: (c: C) => D,\n    fn3: (b: B) => C,\n    fn4: (a: A) => B,\n  ): (a: A) => R;\n  <A, B, C, D, E, R>(\n    fn1: (e: E) => R,\n    fn2: (d: D) => E,\n    fn3: (c: C) => D,\n    fn4: (b: B) => C,\n    fn5: (a: A) => B,\n  ): (a: A) => R;\n  (...fns: ComposeFn[]): (arg: unknown) => unknown;\n};\n\n/**\n * Composes multiple unary functions into a single function, applying them from **right to left**.\n *\n * Often used for building functional pipelines where the innermost function runs first.\n * Types are inferred up to 5 chained functions for full type safety.\n *\n * @param fns - A list of unary functions to compose.\n *\n * @returns A new function that applies all functions from right to left.\n *\n * @example\n * ```ts\n * const add = (x: number) => x + 1;\n * const double = (x: number) => x * 2;\n * const toStr = (x: number) => `Result: ${x}`;\n *\n * const result = compose(toStr, double, add)(2);\n * // => 'Result: 6'\n * ```\n */\nexport const compose: Compose =\n  (...fns: ComposeFn[]) =>\n  (arg: unknown) =>\n    fns.reduceRight((prev, fn) => fn(prev), arg);\n","export const noop = () => {};\n\n/**\n * Invokes the given input if it is a function, passing the provided arguments.\n * Otherwise, returns the input as-is.\n *\n * @template Args - Tuple of argument types to pass to the function.\n * @template Result - Return type of the function or the value.\n *\n * @param input - A function to invoke with `args`, or a direct value of type `Result`.\n * @param args - Arguments to pass if `input` is a function.\n *\n * @returns The result of invoking the function, or the original value if it's not a function.\n */\nexport const invokeIfFunction = <Args extends unknown[], Result>(\n  input: ((...args: Args) => Result) | Result,\n  ...args: Args\n): Result => (typeof input === 'function' ? (input as (...args: Args) => Result)(...args) : input);\n\n/**\n * Creates a promise that resolves after the specified delay.\n *\n * Useful for creating artificial delays, implementing timeouts, or spacing operations.\n *\n * @param delayMs - The delay in milliseconds.\n *\n * @returns A promise that resolves after the specified delay.\n *\n * @example\n * ```ts\n * // Wait for 1 second\n * await delay(1000);\n * console.log('This logs after 1 second');\n *\n * // Use with other async operations\n * async function fetchWithTimeout() {\n *   const timeoutPromise = delay(5000).then(() => {\n *     throw new Error('Request timed out');\n *   });\n *\n *   return Promise.race([fetchData(), timeoutPromise]);\n * }\n * ```\n */\nexport const delay = (delayMs: number): Promise<void> =>\n  new Promise(resolve => setTimeout(resolve, delayMs));\n\ninterface RetryOptions {\n  /**\n   * Maximum number of retry attempts before failing.\n   *\n   * @default 3\n   */\n  maxAttempts?: number;\n  /**\n   * Delay in milliseconds between retry attempts.\n   * If `backoff` is true, this is the base delay for exponential backoff.\n   *\n   * @default 300\n   */\n  delayMs?: number;\n  /**\n   * Whether to use exponential backoff for delays between attempts.\n   * When enabled, the delay is multiplied by 2 ^ (`attempt` - 1).\n   *\n   * @default true\n   */\n  backoff?: boolean;\n  /**\n   * Optional callback triggered before each retry attempt.\n   *\n   * @param attempt - The current attempt number (starting from 1).\n   * @param error - The error that caused the retry.\n   */\n  onRetry?: (attempt: number, error: unknown) => void;\n}\n\n/**\n * Wraps an asynchronous function with retry logic.\n *\n * The returned function will attempt to call the original function up to `maxAttempts` times,\n * with a delay between retries. If all attempts fail, the last encountered error is thrown.\n *\n * Useful for operations that may fail intermittently, such as network requests.\n *\n * @template Task - The type of the async function to wrap.\n * @template TaskResult - The result type of the async function.\n *\n * @param task - The async function to wrap with retry logic.\n * @param options - Configuration options for retry behavior.\n *\n * @returns A function that wraps the original function with retry support.\n *\n * @example\n * ```ts\n * async function fetchData() {\n *   const response = await fetch('/api/data');\n *\n *   if (!response.ok) {\n *    throw new Error('Network error');\n *   }\n *\n *   return await response.json();\n * }\n *\n * const fetchWithRetry = retry(fetchData, {\n *   maxAttempts: 5,\n *   delayMs: 500,\n *   onRetry: (attempt, error) => {\n *     console.warn(`Attempt ${attempt} failed:`, error);\n *   }\n * });\n *\n * fetchWithRetry()\n *   .then(data => console.log('Success:', data))\n *   .catch(error => console.error('Failed after retries:', error));\n * ```\n */\nexport const retry = <Task extends (...args: unknown[]) => Promise<TaskResult>, TaskResult>(\n  task: Task,\n  { maxAttempts = 3, delayMs = 300, backoff = true, onRetry }: RetryOptions = {},\n): ((...args: Parameters<Task>) => Promise<TaskResult>) => {\n  return async (...args: Parameters<Task>): Promise<TaskResult> => {\n    let lastError: unknown;\n\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        return await task(...args);\n      } catch (e) {\n        lastError = e;\n\n        if (attempt < maxAttempts) {\n          onRetry?.(attempt, e);\n\n          const delayTime = backoff ? delayMs * 2 ** (attempt - 1) : delayMs;\n          await delay(delayTime);\n        }\n      }\n    }\n\n    throw lastError;\n  };\n};\n","/**\n * Calculates the Euclidean distance between two points in 2D space.\n *\n * @param startX - The X coordinate of the starting point.\n * @param startY - The Y coordinate of the starting point.\n * @param endX - The X coordinate of the ending point.\n * @param endY - The Y coordinate of the ending point.\n *\n * @returns The Euclidean distance between the two points.\n */\nexport const calculateEuclideanDistance = (\n  startX: number,\n  startY: number,\n  endX: number,\n  endY: number,\n): number => {\n  const deltaX = endX - startX;\n  const deltaY = endY - startY;\n\n  return Math.sqrt(deltaX ** 2 + deltaY ** 2);\n};\n\n/**\n * Calculates the moving speed.\n *\n * @param delta - The change in position (distance).\n * @param elapsedTime - The time taken to move the distance.\n *\n * @returns The calculated speed, which is the absolute value of delta divided by elapsed time.\n */\nexport const calculateMovingSpeed = (delta: number, elapsedTime: number): number =>\n  Math.abs(delta / elapsedTime);\n\n/**\n * Calculates the specified percentage of a given value.\n *\n * @param value - The value to calculate the percentage of.\n * @param percentage - The percentage to calculate.\n *\n * @returns The calculated percentage of the value.\n */\nexport const calculatePercentage = (value: number, percentage: number): number => {\n  return (value * percentage) / 100;\n};\n","interface HTMLElementTransformationValues {\n  translateX: number;\n  translateY: number;\n  scaleX: number;\n  scaleY: number;\n  skewX: number;\n  skewY: number;\n}\n\n/**\n * Extracts transformation values (translate, scale, skew) from the 2D transformation matrix of a given HTML element.\n *\n * Only works with 2D transforms (i.e., `matrix(a, b, c, d, e, f)`).\n *\n * @param element - The element with a CSS transform applied.\n * @returns An object with parsed transformation values.\n *\n * @example\n * ```ts\n * const values = parse2DMatrix(myElement);\n * console.log(values.translateX);\n * console.log(values.scaleX);\n * ```\n */\nexport const parse2DMatrix = (element: HTMLElement): HTMLElementTransformationValues => {\n  const computedStyles = window.getComputedStyle(element);\n  const transformValue = computedStyles.getPropertyValue('transform');\n\n  const matrixMatch = transformValue.match(/^matrix\\((.+)\\)$/);\n  if (!matrixMatch) {\n    return {\n      translateX: 0,\n      translateY: 0,\n      scaleX: 1,\n      scaleY: 1,\n      skewX: 0,\n      skewY: 0,\n    };\n  }\n\n  const [scaleX, skewY, skewX, scaleY, translateX, translateY] = matrixMatch[1]\n    .split(', ')\n    .map(parseFloat);\n\n  return {\n    translateX,\n    translateY,\n    scaleX,\n    scaleY,\n    skewX,\n    skewY,\n  };\n};\n\n/**\n * Creates a clone of a Blob object.\n *\n * @param blob - The Blob object to clone.\n *\n * @returns A new Blob with the same content and type as the original.\n */\nexport const cloneBlob = (blob: Blob): Blob => new Blob([blob], { type: blob.type });\n\n/**\n * Converts a `Blob` object into a `File` object with the specified name.\n *\n * This is useful when you receive a `Blob` (e.g., from canvas, fetch, or file manipulation)\n * and need to convert it into a `File` to upload via `FormData` or file inputs.\n *\n * @param blob - The `Blob` to convert.\n * @param fileName - The desired name for the resulting file (including extension).\n *\n * @returns A `File` instance with the same content and MIME type as the input `Blob`.\n *\n * @example\n * ```ts\n * const blob = new Blob(['Hello world'], { type: 'text/plain' });\n * const file = convertBlobToFile(blob, 'hello.txt');\n *\n * console.log(file instanceof File); // true\n * ```\n */\nexport const convertBlobToFile = (blob: Blob, fileName: string): File =>\n  new File([blob], fileName, {\n    type: blob.type,\n  });\n"],"names":["__webpack_require__","exports","definition","key","o","Object","defineProperty","enumerable","get","obj","prop","prototype","hasOwnProperty","call","Symbol","toStringTag","value","toKebabCase","input","replace","toLowerCase","camelToDashCase","firstChar","charAt","restOfString","slice","letter","splitStringIntoWords","split","filter","Boolean","hashString","hash","i","length","charCodeAt","toString","assert","condition","message","Error","isNull","isNil","isNilOrEmptyString","isDefined","isString","isNumber","isBool","isObject","isEmptyObject","keys","isArray","Array","isEmptyArray","isFunction","isPromise","then","isDate","Date","isValidDate","isNaN","getTime","isRegExp","RegExp","isMap","Map","isSet","Set","isSymbol","isUndefined","undefined","isFiniteNumber","isFinite","isInteger","Number","boolFilter","array","unique","chunk","size","from","Math","ceil","_","index","intersection","arrays","first","rest","item","every","includes","difference","exclude","forAsync","async","predicate","results","push","mapAsync","Promise","all","map","filterAsync","someAsync","everyAsync","reduceAsync","initialValue","accumulator","findAsync","pipe","fns","arg","reduce","prev","fn","compose","reduceRight","noop","invokeIfFunction","args","delay","delayMs","resolve","setTimeout","retry","task","maxAttempts","backoff","onRetry","lastError","attempt","e","delayTime","calculateEuclideanDistance","startX","startY","endX","endY","deltaX","deltaY","sqrt","calculateMovingSpeed","delta","elapsedTime","abs","calculatePercentage","percentage","parse2DMatrix","element","matrixMatch","window","getComputedStyle","getPropertyValue","match","translateX","translateY","scaleX","scaleY","skewX","skewY","parseFloat","cloneBlob","blob","Blob","type","convertBlobToFile","fileName","File"],"sourceRoot":""}

package/dist/index.dev.cjs

@@ -12,6 +12,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   boolFilter: () => (/* binding */ boolFilter),
 /* harmony export */   chunk: () => (/* binding */ chunk),
+/* harmony export */   compose: () => (/* binding */ compose),
 /* harmony export */   difference: () => (/* binding */ difference),
 /* harmony export */   everyAsync: () => (/* binding */ everyAsync),
 /* harmony export */   filterAsync: () => (/* binding */ filterAsync),
@@ -19,6 +20,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   forAsync: () => (/* binding */ forAsync),
 /* harmony export */   intersection: () => (/* binding */ intersection),
 /* harmony export */   mapAsync: () => (/* binding */ mapAsync),
+/* harmony export */   pipe: () => (/* binding */ pipe),
 /* harmony export */   reduceAsync: () => (/* binding */ reduceAsync),
 /* harmony export */   someAsync: () => (/* binding */ someAsync),
 /* harmony export */   unique: () => (/* binding */ unique)
@@ -130,9 +132,9 @@ const difference = (array, exclude) => array.filter(item => !exclude.includes(it
  * Useful when order or timing matters (e.g., rate limits, UI updates, animations).
  *
  * @param array - The array of items to iterate over.
- * @param callbackFn - An async function to execute for each item. Must return a value.
+ * @param predicate - An async function to execute for each item. Must return a value.
  *
- * @returns A promise that resolves with an array of results from each callback call.
+ * @returns A promise that resolves with an array of results from each predicate call.
  *
  * @example
  * ```ts
@@ -145,10 +147,10 @@ const difference = (array, exclude) => array.filter(item => !exclude.includes(it
  * console.log(results); // [2, 4, 6]
  * ```
  */
-const forAsync = async (array, callbackFn) => {
+const forAsync = async (array, predicate) => {
     const results = [];
     for (let i = 0; i < array.length; i++) {
-        results.push(await callbackFn(array[i], i, array));
+        results.push(await predicate(array[i], i, array));
     }
     return results;
 };
@@ -156,11 +158,11 @@ const forAsync = async (array, callbackFn) => {
  * Executes an asynchronous operation on each element of an array and waits for all promises to resolve.
  *
  * @param array - The array of items to operate on.
- * @param callbackFn - The asynchronous operation to perform on each item.
+ * @param predicate - The asynchronous operation to perform on each item.
  *
  * @returns A promise that resolves with an array of results after all operations are completed.
  */
-const mapAsync = async (array, callbackFn) => Promise.all(array.map(callbackFn));
+const mapAsync = async (array, predicate) => Promise.all(array.map(predicate));
 /**
  * A generic function that processes an array asynchronously and filters the results
  * based on the provided async condition.
@@ -169,25 +171,25 @@ const mapAsync = async (array, callbackFn) => Promise.all(array.map(callbackFn))
  * @template Return - The type of the items returned by the condition.
  *
  * @param array - An array of items to be processed.
- * @param callbackFn - An async function that returns a condition for each item.
+ * @param predicate - An async function that returns a condition for each item.
  *
  * @returns A Promise that resolves to an array of items that match the condition.
  */
-const filterAsync = async (array, callbackFn) => {
-    const results = await mapAsync(array, async (item, index, array) => (await callbackFn(item, index, array)) ? item : false);
+const filterAsync = async (array, predicate) => {
+    const results = await mapAsync(array, async (item, index, array) => (await predicate(item, index, array)) ? item : false);
     return boolFilter(results);
 };
 /**
  * Asynchronously checks if at least one element in the array satisfies the async condition.
  *
  * @param array - The array of items to check.
- * @param callbackFn - An async function that returns a boolean.
+ * @param predicate - An async function that returns a boolean.
  *
  * @returns A promise that resolves to true if any item passes the condition.
  */
-const someAsync = async (array, callbackFn) => {
+const someAsync = async (array, predicate) => {
     for (let i = 0; i < array.length; i++) {
-        if (await callbackFn(array[i], i, array)) {
+        if (await predicate(array[i], i, array)) {
             return true;
         }
     }
@@ -197,13 +199,13 @@ const someAsync = async (array, callbackFn) => {
  * Asynchronously checks if all elements in the array satisfy the async condition.
  *
  * @param array - The array of items to check.
- * @param callbackFn - An async function that returns a boolean.
+ * @param predicate - An async function that returns a boolean.
  *
  * @returns A promise that resolves to true if all items pass the condition.
  */
-const everyAsync = async (array, callbackFn) => {
+const everyAsync = async (array, predicate) => {
     for (let i = 0; i < array.length; i++) {
-        if (!(await callbackFn(array[i], i, array))) {
+        if (!(await predicate(array[i], i, array))) {
             return false;
         }
     }
@@ -216,15 +218,15 @@ const everyAsync = async (array, callbackFn) => {
  * @template Accumulator - The type of the accumulated result.
  *
  * @param array - The array to reduce.
- * @param callbackFn - The async reducer function that processes each item and returns the updated accumulator.
+ * @param predicate - The async reducer function that processes each item and returns the updated accumulator.
  * @param initialValue - The initial accumulator value.
  *
  * @returns A promise that resolves to the final accumulated result.
  */
-const reduceAsync = async (array, callbackFn, initialValue) => {
+const reduceAsync = async (array, predicate, initialValue) => {
     let accumulator = initialValue;
     for (let i = 0; i < array.length; i++) {
-        accumulator = await callbackFn(accumulator, array[i], i, array);
+        accumulator = await predicate(accumulator, array[i], i, array);
     }
     return accumulator;
 };
@@ -232,18 +234,61 @@ const reduceAsync = async (array, callbackFn, initialValue) => {
  * Asynchronously finds the first element that satisfies the async condition.
  *
  * @param array - The array of items to search.
- * @param callbackFn - An async function that returns a boolean.
+ * @param predicate - An async function that returns a boolean.
  *
  * @returns A promise that resolves to the found item or null if none match.
  */
-const findAsync = async (array, callbackFn) => {
+const findAsync = async (array, predicate) => {
     for (let i = 0; i < array.length; i++) {
-        if (await callbackFn(array[i], i, array)) {
+        if (await predicate(array[i], i, array)) {
             return array[i];
         }
     }
     return null;
 };
+/**
+ * Composes multiple unary functions into a single function, applying them from left to right.
+ *
+ * Useful for building a data processing pipeline where the output of one function becomes the input of the next.
+ *
+ * Types are inferred up to 5 chained functions for full type safety. Beyond that, it falls back to the unknown.
+ *
+ * @param fns - A list of unary functions to compose.
+ *
+ * @returns A new function that applies all functions from left to right.
+ *
+ * @example
+ * ```ts
+ * const add = (x: number) => x + 1;
+ * const double = (x: number) => x * 2;
+ * const toStr = (x: number) => `Result: ${x}`;
+ *
+ * const result = pipe(add, double, toStr)(2);
+ * // => 'Result: 6'
+ * ```
+ */
+const pipe = (...fns) => (arg) => fns.reduce((prev, fn) => fn(prev), arg);
+/**
+ * Composes multiple unary functions into a single function, applying them from **right to left**.
+ *
+ * Often used for building functional pipelines where the innermost function runs first.
+ * Types are inferred up to 5 chained functions for full type safety.
+ *
+ * @param fns - A list of unary functions to compose.
+ *
+ * @returns A new function that applies all functions from right to left.
+ *
+ * @example
+ * ```ts
+ * const add = (x: number) => x + 1;
+ * const double = (x: number) => x * 2;
+ * const toStr = (x: number) => `Result: ${x}`;
+ *
+ * const result = compose(toStr, double, add)(2);
+ * // => 'Result: 6'
+ * ```
+ */
+const compose = (...fns) => (arg) => fns.reduceRight((prev, fn) => fn(prev), arg);
 
 
 /***/ }),
@@ -464,6 +509,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   isArray: () => (/* binding */ isArray),
 /* harmony export */   isBool: () => (/* binding */ isBool),
 /* harmony export */   isDate: () => (/* binding */ isDate),
+/* harmony export */   isDefined: () => (/* binding */ isDefined),
 /* harmony export */   isEmptyArray: () => (/* binding */ isEmptyArray),
 /* harmony export */   isEmptyObject: () => (/* binding */ isEmptyObject),
 /* harmony export */   isFiniteNumber: () => (/* binding */ isFiniteNumber),
@@ -496,6 +542,35 @@ function assert(condition, message) {
  * @returns `true` if the value is null; otherwise, `false`.
  */
 const isNull = (value) => value === null;
+/**
+ * Checks if a value is null or undefined.
+ *
+ * @param value - The value to check.
+ *
+ * @returns `true` if the value is `null` or `undefined`, otherwise `false`.
+ */
+const isNil = (value) => value === undefined || value === null;
+/**
+ * Checks whether the provided value is considered "empty".
+ *
+ * A value is considered empty if it is:
+ * - `null`
+ * - `undefined`
+ * - `''`
+ *
+ * @param value - The value to check.
+ *
+ * @returns `true` if the value is empty; otherwise, `false`.
+ */
+const isNilOrEmptyString = (value) => value === '' || isNil(value);
+/**
+ * Checks if a value is neither `null` nor `undefined`.
+ *
+ * @param value - The value to check.
+ *
+ * @returns `true` if the value is defined (not `null` or `undefined`); otherwise, `false`.
+ */
+const isDefined = (value) => value !== null && value !== undefined;
 /**
  * Checks if a value is a string.
  *
@@ -570,27 +645,6 @@ const isFunction = (value) => typeof value === 'function';
  * @returns `true` if the value is a Promise; otherwise, `false`.
  */
 const isPromise = (value) => isFunction(value?.then);
-/**
- * Checks if a value is null or undefined.
- *
- * @param value - The value to check.
- *
- * @returns `true` if the value is `null` or `undefined`, otherwise `false`.
- */
-const isNil = (value) => value === undefined || value === null;
-/**
- * Checks whether the provided value is considered "empty".
- *
- * A value is considered empty if it is:
- * - `null`
- * - `undefined`
- * - `''`
- *
- * @param value - The value to check.
- *
- * @returns `true` if the value is empty; otherwise, `false`.
- */
-const isNilOrEmptyString = (value) => value === '' || isNil(value);
 /**
  * Checks if a value is a Date object.
  *
@@ -893,6 +947,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   camelToDashCase: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_0__.camelToDashCase),
 /* harmony export */   chunk: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.chunk),
 /* harmony export */   cloneBlob: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_5__.cloneBlob),
+/* harmony export */   compose: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.compose),
 /* harmony export */   convertBlobToFile: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_5__.convertBlobToFile),
 /* harmony export */   delay: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_2__.delay),
 /* harmony export */   difference: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.difference),
@@ -906,6 +961,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   isArray: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_3__.isArray),
 /* harmony export */   isBool: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_3__.isBool),
 /* harmony export */   isDate: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_3__.isDate),
+/* harmony export */   isDefined: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_3__.isDefined),
 /* harmony export */   isEmptyArray: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_3__.isEmptyArray),
 /* harmony export */   isEmptyObject: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_3__.isEmptyObject),
 /* harmony export */   isFiniteNumber: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_3__.isFiniteNumber),
@@ -927,6 +983,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   mapAsync: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.mapAsync),
 /* harmony export */   noop: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_2__.noop),
 /* harmony export */   parse2DMatrix: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_5__.parse2DMatrix),
+/* harmony export */   pipe: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.pipe),
 /* harmony export */   reduceAsync: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.reduceAsync),
 /* harmony export */   retry: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_2__.retry),
 /* harmony export */   someAsync: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.someAsync),