npm - @react-hive/honey-utils - Versions diffs - 1.3.0 → 1.5.0 - Mend

@react-hive/honey-utils 1.3.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/README.md CHANGED Viewed

@@ -3,6 +3,10 @@
 [![npm version](https://img.shields.io/npm/v/@react-hive/honey-utils.svg)](https://www.npmjs.com/package/@react-hive/honey-utils)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+<p align="center">
+  <img src="./logo.png" alt="honey-utils logo" width="200" height="200">
+</p>
 A lightweight TypeScript utility library providing a collection of helper functions for common programming tasks.
 ## Features
@@ -62,17 +66,34 @@ const hash = hashString('background-color: red;'); // 'e4k1z0x'
 ### Array Utilities
 ```typescript
-import { boolFilter } from '@react-hive/honey-utils';
+import {
+  boolFilter,
+  unique,
+  chunk,
+  intersection,
+  difference
+} from '@react-hive/honey-utils';
 // Filter out falsy values from an array
-const array = [0, 1, false, 2, '', 3, null, undefined, true];
-boolFilter(array); // [1, 2, 3, true]
+boolFilter([0, 1, false, 2, '', 3, null, undefined, true]); // [1, 2, 3, true]
+// Remove duplicate values from an array
+unique([1, 2, 2, 3, 1, 4]); // [1, 2, 3, 4]
+// Split an array into chunks of specified size
+chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
+// Find common elements between arrays
+intersection([1, 2, 3], [2, 3, 4]); // [2, 3]
+// Find elements in one array not in another
+difference([1, 2, 3, 4], [2, 4]); // [1, 3]
 ```
 ### Function Utilities
 ```typescript
-import { noop, invokeIfFunction } from '@react-hive/honey-utils';
+import { noop, invokeIfFunction, delay, retry } from '@react-hive/honey-utils';
 // No-operation function
 noop(); // does nothing
@@ -82,6 +103,33 @@ const fn = (x: number) => x * 2;
 invokeIfFunction(fn, 5); // 10
 invokeIfFunction('not a function', 5); // 'not a function'
+// Create a promise that resolves after a specified delay
+await delay(1000); // Waits for 1 second before continuing
+// Retry an async function with configurable options
+async function fetchData() {
+  const response = await fetch('/api/data');
+  if (!response.ok) {
+    throw new Error('Network error');
+  }
+  return await response.json();
+}
+const fetchWithRetry = retry(fetchData, {
+  maxAttempts: 5,
+  delayMs: 500,
+  backoff: true,
+  onRetry: (attempt, error) => {
+    console.warn(`Attempt ${attempt} failed:`, error);
+  }
+});
+fetchWithRetry()
+  .then(data => console.log('Success:', data))
+  .catch(error => console.error('Failed after retries:', error));
 ```
 ### Type Guards
@@ -228,11 +276,17 @@ function divide(a: number, b: number): number {
 ### Array Utilities
 - **boolFilter<T>(array: (T | false | null | undefined)[]): T[]** - Filters out falsy values from an array
+- **unique<T>(array: T[]): T[]** - Returns a new array with duplicate values removed
+- **chunk<T>(array: T[], size: number): T[][]** - Splits an array into chunks of the specified size
+- **intersection<T>(...arrays: T[][]): T[]** - Returns an array containing elements that exist in all provided arrays
+- **difference<T>(array: T[], exclude: T[]): T[]** - Returns elements from the first array that don't exist in the second array
 ### Function Utilities
 - **noop(): void** - A no-operation function
 - **invokeIfFunction<Args extends any[], Result>(input: ((...args: Args) => Result) | Result, ...args: Args): Result** - Invokes the input if it's a function, otherwise returns it as-is
+- **delay(delayMs: number): Promise<void>** - Creates a promise that resolves after the specified delay in milliseconds
+- **retry<Task, TaskResult>(task: Task, options?: RetryOptions): Function** - Wraps an asynchronous function with retry logic, with configurable max attempts, delay between retries, exponential backoff, and retry callbacks
 ### Type Guards

package/dist/README.md CHANGED Viewed

@@ -3,6 +3,10 @@
 [![npm version](https://img.shields.io/npm/v/@react-hive/honey-utils.svg)](https://www.npmjs.com/package/@react-hive/honey-utils)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+<p align="center">
+  <img src="./logo.png" alt="honey-utils logo" width="200" height="200">
+</p>
 A lightweight TypeScript utility library providing a collection of helper functions for common programming tasks.
 ## Features
@@ -62,17 +66,34 @@ const hash = hashString('background-color: red;'); // 'e4k1z0x'
 ### Array Utilities
 ```typescript
-import { boolFilter } from '@react-hive/honey-utils';
+import {
+  boolFilter,
+  unique,
+  chunk,
+  intersection,
+  difference
+} from '@react-hive/honey-utils';
 // Filter out falsy values from an array
-const array = [0, 1, false, 2, '', 3, null, undefined, true];
-boolFilter(array); // [1, 2, 3, true]
+boolFilter([0, 1, false, 2, '', 3, null, undefined, true]); // [1, 2, 3, true]
+// Remove duplicate values from an array
+unique([1, 2, 2, 3, 1, 4]); // [1, 2, 3, 4]
+// Split an array into chunks of specified size
+chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
+// Find common elements between arrays
+intersection([1, 2, 3], [2, 3, 4]); // [2, 3]
+// Find elements in one array not in another
+difference([1, 2, 3, 4], [2, 4]); // [1, 3]
 ```
 ### Function Utilities
 ```typescript
-import { noop, invokeIfFunction } from '@react-hive/honey-utils';
+import { noop, invokeIfFunction, delay, retry } from '@react-hive/honey-utils';
 // No-operation function
 noop(); // does nothing
@@ -82,6 +103,33 @@ const fn = (x: number) => x * 2;
 invokeIfFunction(fn, 5); // 10
 invokeIfFunction('not a function', 5); // 'not a function'
+// Create a promise that resolves after a specified delay
+await delay(1000); // Waits for 1 second before continuing
+// Retry an async function with configurable options
+async function fetchData() {
+  const response = await fetch('/api/data');
+  if (!response.ok) {
+    throw new Error('Network error');
+  }
+  return await response.json();
+}
+const fetchWithRetry = retry(fetchData, {
+  maxAttempts: 5,
+  delayMs: 500,
+  backoff: true,
+  onRetry: (attempt, error) => {
+    console.warn(`Attempt ${attempt} failed:`, error);
+  }
+});
+fetchWithRetry()
+  .then(data => console.log('Success:', data))
+  .catch(error => console.error('Failed after retries:', error));
 ```
 ### Type Guards
@@ -228,11 +276,17 @@ function divide(a: number, b: number): number {
 ### Array Utilities
 - **boolFilter<T>(array: (T | false | null | undefined)[]): T[]** - Filters out falsy values from an array
+- **unique<T>(array: T[]): T[]** - Returns a new array with duplicate values removed
+- **chunk<T>(array: T[], size: number): T[][]** - Splits an array into chunks of the specified size
+- **intersection<T>(...arrays: T[][]): T[]** - Returns an array containing elements that exist in all provided arrays
+- **difference<T>(array: T[], exclude: T[]): T[]** - Returns elements from the first array that don't exist in the second array
 ### Function Utilities
 - **noop(): void** - A no-operation function
 - **invokeIfFunction<Args extends any[], Result>(input: ((...args: Args) => Result) | Result, ...args: Args): Result** - Invokes the input if it's a function, otherwise returns it as-is
+- **delay(delayMs: number): Promise<void>** - Creates a promise that resolves after the specified delay in milliseconds
+- **retry<Task, TaskResult>(task: Task, options?: RetryOptions): Function** - Wraps an asynchronous function with retry logic, with configurable max attempts, delay between retries, exponential backoff, and retry callbacks
 ### Type Guards

package/dist/array.d.ts CHANGED Viewed

@@ -11,3 +11,74 @@
  * @returns A new array containing only truthy `Item` values.
  */
 export declare const boolFilter: <T>(array: (T | false | null | undefined)[]) => T[];
+/**
+ * Returns a new array with duplicate values removed.
+ *
+ * Uses Set for efficient duplicate removal while preserving the original order.
+ *
+ * @template T - The type of the items in the array.
+ *
+ * @param array - The input array that may contain duplicate values.
+ *
+ * @returns A new array with only unique values, maintaining the original order.
+ *
+ * @example
+ * ```ts
+ * unique([1, 2, 2, 3, 1, 4]); // [1, 2, 3, 4]
+ * unique(['a', 'b', 'a', 'c']); // ['a', 'b', 'c']
+ * ```
+ */
+export declare const unique: <T>(array: T[]) => T[];
+/**
+ * Splits an array into chunks of the specified size.
+ *
+ * Useful for pagination, batch processing, or creating grid layouts.
+ *
+ * @template T - The type of the items in the array.
+ *
+ * @param array - The input array to be chunked.
+ * @param size - The size of each chunk. Must be greater than 0.
+ *
+ * @returns An array of chunks, where each chunk is an array of the specified size
+ *          (except possibly the last chunk, which may be smaller).
+ *
+ * @example
+ * ```ts
+ * chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
+ * chunk(['a', 'b', 'c', 'd'], 3); // [['a', 'b', 'c'], ['d']]
+ * ```
+ */
+export declare const chunk: <T>(array: T[], size: number) => T[][];
+/**
+ * Returns an array containing elements that exist in all provided arrays.
+ *
+ * @template T - The type of the items in the arrays.
+ *
+ * @param arrays - Two or more arrays to find common elements from.
+ *
+ * @returns A new array containing only the elements that exist in all input arrays.
+ *
+ * @example
+ * ```ts
+ * intersection([1, 2, 3], [2, 3, 4]); // [2, 3]
+ * intersection(['a', 'b', 'c'], ['b', 'c', 'd'], ['b', 'e']); // ['b']
+ * ```
+ */
+export declare const intersection: <T>(...arrays: T[][]) => T[];
+/**
+ * Returns elements from the first array that don't exist in the second array.
+ *
+ * @template T - The type of the items in the arrays.
+ *
+ * @param array - The source array.
+ * @param exclude - The array containing elements to exclude.
+ *
+ * @returns A new array with elements from the first array that don't exist in the second array.
+ *
+ * @example
+ * ```ts
+ * difference([1, 2, 3, 4], [2, 4]); // [1, 3]
+ * difference(['a', 'b', 'c'], ['b']); // ['a', 'c']
+ * ```
+ */
+export declare const difference: <T>(array: T[], exclude: T[]) => T[];

package/dist/function.d.ts CHANGED Viewed

@@ -11,4 +11,102 @@ export declare const noop: () => void;
  *
  * @returns The result of invoking the function, or the original value if it's not a function.
  */
-export declare const invokeIfFunction: <Args extends any[], Result>(input: ((...args: Args) => Result) | Result, ...args: Args) => Result;
+export declare const invokeIfFunction: <Args extends unknown[], Result>(input: ((...args: Args) => Result) | Result, ...args: Args) => Result;
+/**
+ * Creates a promise that resolves after the specified delay.
+ *
+ * Useful for creating artificial delays, implementing timeouts, or spacing operations.
+ *
+ * @param delayMs - The delay in milliseconds.
+ *
+ * @returns A promise that resolves after the specified delay.
+ *
+ * @example
+ * ```ts
+ * // Wait for 1 second
+ * await delay(1000);
+ * console.log('This logs after 1 second');
+ *
+ * // Use with other async operations
+ * async function fetchWithTimeout() {
+ *   const timeoutPromise = delay(5000).then(() => {
+ *     throw new Error('Request timed out');
+ *   });
+ *
+ *   return Promise.race([fetchData(), timeoutPromise]);
+ * }
+ * ```
+ */
+export declare const delay: (delayMs: number) => Promise<void>;
+interface RetryOptions {
+    /**
+     * Maximum number of retry attempts before failing.
+     *
+     * @default 3
+     */
+    maxAttempts?: number;
+    /**
+     * Delay in milliseconds between retry attempts.
+     * If `backoff` is true, this is the base delay for exponential backoff.
+     *
+     * @default 300
+     */
+    delayMs?: number;
+    /**
+     * Whether to use exponential backoff for delays between attempts.
+     * When enabled, the delay is multiplied by 2 ^ (`attempt` - 1).
+     *
+     * @default true
+     */
+    backoff?: boolean;
+    /**
+     * Optional callback triggered before each retry attempt.
+     *
+     * @param attempt - The current attempt number (starting from 1).
+     * @param error - The error that caused the retry.
+     */
+    onRetry?: (attempt: number, error: unknown) => void;
+}
+/**
+ * Wraps an asynchronous function with retry logic.
+ *
+ * The returned function will attempt to call the original function up to `maxAttempts` times,
+ * with a delay between retries. If all attempts fail, the last encountered error is thrown.
+ *
+ * Useful for operations that may fail intermittently, such as network requests.
+ *
+ * @template Task - The type of the async function to wrap.
+ * @template TaskResult - The result type of the async function.
+ *
+ * @param task - The async function to wrap with retry logic.
+ * @param options - Configuration options for retry behavior.
+ *
+ * @returns A function that wraps the original function with retry support.
+ *
+ * @example
+ * ```ts
+ * async function fetchData() {
+ *   const response = await fetch('/api/data');
+ *
+ *   if (!response.ok) {
+ *    throw new Error('Network error');
+ *   }
+ *
+ *   return await response.json();
+ * }
+ *
+ * const fetchWithRetry = retry(fetchData, {
+ *   maxAttempts: 5,
+ *   delayMs: 500,
+ *   onRetry: (attempt, error) => {
+ *     console.warn(`Attempt ${attempt} failed:`, error);
+ *   }
+ * });
+ *
+ * fetchWithRetry()
+ *   .then(data => console.log('Success:', data))
+ *   .catch(error => console.error('Failed after retries:', error));
+ * ```
+ */
+export declare const retry: <Task extends (...args: unknown[]) => Promise<TaskResult>, TaskResult>(task: Task, { maxAttempts, delayMs, backoff, onRetry }?: RetryOptions) => ((...args: Parameters<Task>) => Promise<TaskResult>);
+export {};

package/dist/guards.d.ts CHANGED Viewed

@@ -1,3 +1,4 @@
+export declare function assert(condition: any, message: string): asserts condition;
 /**
  * Checks if a value is null.
  *

package/dist/index.cjs CHANGED Viewed

@@ -1,2 +1,2 @@
-(()=>{"use strict";var e={d:(t,o)=>{for(var r in o)e.o(o,r)&&!e.o(t,r)&&Object.defineProperty(t,r,{enumerable:!0,get:o[r]})},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:()=>a,calculateEuclideanDistance:()=>C,calculateMovingSpeed:()=>D,calculatePercentage:()=>T,camelToDashCase:()=>r,getTransformationValues:()=>x,hashString:()=>n,invokeIfFunction:()=>l,isArray:()=>b,isBool:()=>f,isDate:()=>j,isEmptyArray:()=>m,isEmptyObject:()=>g,isFiniteNumber:()=>M,isFunction:()=>d,isInteger:()=>P,isMap:()=>w,isNil:()=>h,isNilOrEmptyString:()=>O,isNull:()=>c,isNumber:()=>u,isObject:()=>y,isPromise:()=>S,isRegExp:()=>v,isSet:()=>A,isString:()=>p,isSymbol:()=>E,isUndefined:()=>F,isValidDate:()=>N,noop:()=>s,splitStringIntoWords:()=>i,toKebabCase:()=>o});const o=e=>e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").toLowerCase(),r=e=>e.replace(/[A-Z]/g,e=>`-${e.toLowerCase()}`),i=e=>e.split(" ").filter(Boolean),n=e=>{let t=5381;for(let o=0;o<e.length;o++)t=33*t^e.charCodeAt(o);return(t>>>0).toString(36)},a=e=>e.filter(Boolean),s=()=>{},l=(e,...t)=>"function"==typeof e?e(...t):e,c=e=>null===e,p=e=>"string"==typeof e,u=e=>"number"==typeof e,f=e=>"boolean"==typeof e,y=e=>"object"==typeof e,g=e=>y(e)&&!c(e)&&0===Object.keys(e).length,b=e=>Array.isArray(e),m=e=>b(e)&&0===e.length,d=e=>"function"==typeof e,S=e=>d(e?.then),h=e=>null==e,O=e=>""===e||h(e),j=e=>e instanceof Date,N=e=>j(e)&&!isNaN(e.getTime()),v=e=>e instanceof RegExp,w=e=>e instanceof Map,A=e=>e instanceof Set,E=e=>"symbol"==typeof e,F=e=>void 0===e,M=e=>u(e)&&isFinite(e),P=e=>u(e)&&Number.isInteger(e),C=(e,t,o,r)=>{const i=o-e,n=r-t;return Math.sqrt(i**2+n**2)},D=(e,t)=>Math.abs(e/t),T=(e,t)=>e*t/100,x=e=>{const t=window.getComputedStyle(e).getPropertyValue("transform").match(/^matrix\((.+)\)$/);if(!t)return{translateX:0,translateY:0};const o=t[1].split(", ");return{translateX:parseFloat(o[4]),translateY:parseFloat(o[5])}};function I(e,t){if(!e)throw new Error(t)}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:()=>a,boolFilter:()=>P,calculateEuclideanDistance:()=>B,calculateMovingSpeed:()=>L,calculatePercentage:()=>R,camelToDashCase:()=>n,chunk:()=>F,delay:()=>I,difference:()=>k,getTransformationValues:()=>V,hashString:()=>i,intersection:()=>T,invokeIfFunction:()=>D,isArray:()=>p,isBool:()=>u,isDate:()=>S,isEmptyArray:()=>g,isEmptyObject:()=>y,isFiniteNumber:()=>C,isFunction:()=>m,isInteger:()=>N,isMap:()=>M,isNil:()=>d,isNilOrEmptyString:()=>h,isNull:()=>s,isNumber:()=>c,isObject:()=>f,isPromise:()=>b,isRegExp:()=>A,isSet:()=>O,isString:()=>l,isSymbol:()=>j,isUndefined:()=>v,isValidDate:()=>w,noop:()=>x,retry:()=>$,splitStringIntoWords:()=>o,toKebabCase:()=>r,unique:()=>E});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()}`)},o=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 a(e,t){if(!e)throw new Error(t)}const s=e=>null===e,l=e=>"string"==typeof e,c=e=>"number"==typeof e,u=e=>"boolean"==typeof e,f=e=>"object"==typeof e,y=e=>f(e)&&!s(e)&&0===Object.keys(e).length,p=e=>Array.isArray(e),g=e=>p(e)&&0===e.length,m=e=>"function"==typeof e,b=e=>m(e?.then),d=e=>null==e,h=e=>""===e||d(e),S=e=>e instanceof Date,w=e=>S(e)&&!isNaN(e.getTime()),A=e=>e instanceof RegExp,M=e=>e instanceof Map,O=e=>e instanceof Set,j=e=>"symbol"==typeof e,v=e=>void 0===e,C=e=>c(e)&&isFinite(e),N=e=>c(e)&&Number.isInteger(e),P=e=>e.filter(Boolean),E=e=>[...new Set(e)],F=(e,t)=>(a(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))),T=(...e)=>{if(0===e.length)return[];if(1===e.length)return[...e[0]];const[t,...r]=e;return E(t).filter(e=>r.every(t=>t.includes(e)))},k=(e,t)=>e.filter(e=>!t.includes(e)),x=()=>{},D=(e,...t)=>"function"==typeof e?e(...t):e,I=e=>new Promise(t=>setTimeout(t,e)),$=(e,{maxAttempts:t=3,delayMs:r=300,backoff:n=!0,onRetry:o}={})=>async(...i)=>{let a;for(let s=1;s<=t;s++)try{return await e(...i)}catch(e){if(a=e,s<t){o?.(s,e);const t=n?r*2**(s-1):r;await I(t)}}throw a},B=(e,t,r,n)=>{const o=r-e,i=n-t;return Math.sqrt(o**2+i**2)},L=(e,t)=>Math.abs(e/t),R=(e,t)=>e*t/100,V=e=>{const t=window.getComputedStyle(e).getPropertyValue("transform").match(/^matrix\((.+)\)$/);if(!t)return{translateX:0,translateY:0};const r=t[1].split(", ");return{translateX:parseFloat(r[4]),translateY:parseFloat(r[5])}};module.exports=t})();
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +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/array.ts","webpack://@react-hive/honey-utils/./src/function.ts","webpack://@react-hive/honey-utils/./src/guards.ts","webpack://@react-hive/honey-utils/./src/math.ts","webpack://@react-hive/honey-utils/./src/dom.ts","webpack://@react-hive/honey-utils/./src/index.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};","export const toKebabCase = (input: string): string =>\n input.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();\n\nexport const camelToDashCase = (input: string): string =>\n input.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);\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","/*\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","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 any[], Result>(\n input: ((...args: Args) => Result) \| Result,\n ...args: Args\n): Result => (typeof input === 'function' ? (input as (...args: Args) => Result)(...args) : input);\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","/\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}\n\n/*\n Get various transformation values from the transformation matrix of an element.\n \n @param element - The element with a transformation applied.\n \n @returns An object containing transformation values.\n /\nexport const getTransformationValues = (element: HTMLElement): HTMLElementTransformationValues => {\n const computedStyles = window.getComputedStyle(element);\n const transformValue = computedStyles.getPropertyValue('transform');\n\n const matrix = transformValue.match(/^matrix\$(.+)\$$/);\n if (!matrix) {\n return {\n translateX: 0,\n translateY: 0,\n };\n }\n\n const transformMatrix = matrix[1].split(', ');\n\n const translateX = parseFloat(transformMatrix[4]);\n const translateY = parseFloat(transformMatrix[5]);\n\n return {\n translateX,\n translateY,\n };\n};\n","export from './string';\nexport * from './array';\nexport * from './function';\nexport * from './guards';\nexport * from './math';\nexport * from './dom';\n\nexport function assert(condition: any, message: string): asserts condition {\n if (!condition) {\n throw new Error(message);\n }\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","letter","splitStringIntoWords","split","filter","Boolean","hashString","hash","i","length","charCodeAt","toString","boolFilter","array","noop","invokeIfFunction","args","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","calculateEuclideanDistance","startX","startY","endX","endY","deltaX","deltaY","Math","sqrt","calculateMovingSpeed","delta","elapsedTime","abs","calculatePercentage","percentage","getTransformationValues","element","matrix","window","getComputedStyle","getPropertyValue","match","translateX","translateY","transformMatrix","parseFloat","assert","condition","message","Error"],"sourceRoot":""}
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","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}\n\n/*\n Get various transformation values from the transformation matrix of an element.\n \n @param element - The element with a transformation applied.\n \n @returns An object containing transformation values.\n */\nexport const getTransformationValues = (element: HTMLElement): HTMLElementTransformationValues => {\n const computedStyles = window.getComputedStyle(element);\n const transformValue = computedStyles.getPropertyValue('transform');\n\n const matrix = transformValue.match(/^matrix\$(.+)\$$/);\n if (!matrix) {\n return {\n translateX: 0,\n translateY: 0,\n };\n }\n\n const transformMatrix = matrix[1].split(', ');\n\n const translateX = parseFloat(transformMatrix[4]);\n const translateY = parseFloat(transformMatrix[5]);\n\n return {\n translateX,\n translateY,\n };\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","noop","invokeIfFunction","args","delay","delayMs","Promise","resolve","setTimeout","retry","task","maxAttempts","backoff","onRetry","async","lastError","attempt","e","delayTime","calculateEuclideanDistance","startX","startY","endX","endY","deltaX","deltaY","sqrt","calculateMovingSpeed","delta","elapsedTime","abs","calculatePercentage","percentage","getTransformationValues","element","matrix","window","getComputedStyle","getPropertyValue","match","translateX","translateY","transformMatrix","parseFloat"],"sourceRoot":""}

package/dist/index.d.ts CHANGED Viewed

@@ -4,4 +4,3 @@ export * from './function';
 export * from './guards';
 export * from './math';
 export * from './dom';
-export declare function assert(condition: any, message: string): asserts condition;

package/dist/index.dev.cjs CHANGED Viewed

@@ -10,8 +10,14 @@
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
-/* harmony export */   boolFilter: () => (/* binding */ boolFilter)
+/* harmony export */   boolFilter: () => (/* binding */ boolFilter),
+/* harmony export */   chunk: () => (/* binding */ chunk),
+/* harmony export */   difference: () => (/* binding */ difference),
+/* harmony export */   intersection: () => (/* binding */ intersection),
+/* harmony export */   unique: () => (/* binding */ unique)
 /* harmony export */ });
+/* harmony import */ var _guards__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./guards */ "./src/guards.ts");
 /**
  * Filters out `null`, `undefined`, and other falsy values from an array,
  * returning a typed array of only truthy `Item` values.
@@ -25,6 +31,90 @@ __webpack_require__.r(__webpack_exports__);
  * @returns A new array containing only truthy `Item` values.
  */
 const boolFilter = (array) => array.filter(Boolean);
+/**
+ * Returns a new array with duplicate values removed.
+ *
+ * Uses Set for efficient duplicate removal while preserving the original order.
+ *
+ * @template T - The type of the items in the array.
+ *
+ * @param array - The input array that may contain duplicate values.
+ *
+ * @returns A new array with only unique values, maintaining the original order.
+ *
+ * @example
+ * ```ts
+ * unique([1, 2, 2, 3, 1, 4]); // [1, 2, 3, 4]
+ * unique(['a', 'b', 'a', 'c']); // ['a', 'b', 'c']
+ * ```
+ */
+const unique = (array) => [...new Set(array)];
+/**
+ * Splits an array into chunks of the specified size.
+ *
+ * Useful for pagination, batch processing, or creating grid layouts.
+ *
+ * @template T - The type of the items in the array.
+ *
+ * @param array - The input array to be chunked.
+ * @param size - The size of each chunk. Must be greater than 0.
+ *
+ * @returns An array of chunks, where each chunk is an array of the specified size
+ *          (except possibly the last chunk, which may be smaller).
+ *
+ * @example
+ * ```ts
+ * chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
+ * chunk(['a', 'b', 'c', 'd'], 3); // [['a', 'b', 'c'], ['d']]
+ * ```
+ */
+const chunk = (array, size) => {
+    (0,_guards__WEBPACK_IMPORTED_MODULE_0__.assert)(size > 0, 'Chunk size must be greater than 0');
+    return Array.from({ length: Math.ceil(array.length / size) }, (_, index) => array.slice(index * size, (index + 1) * size));
+};
+/**
+ * Returns an array containing elements that exist in all provided arrays.
+ *
+ * @template T - The type of the items in the arrays.
+ *
+ * @param arrays - Two or more arrays to find common elements from.
+ *
+ * @returns A new array containing only the elements that exist in all input arrays.
+ *
+ * @example
+ * ```ts
+ * intersection([1, 2, 3], [2, 3, 4]); // [2, 3]
+ * intersection(['a', 'b', 'c'], ['b', 'c', 'd'], ['b', 'e']); // ['b']
+ * ```
+ */
+const intersection = (...arrays) => {
+    if (arrays.length === 0) {
+        return [];
+    }
+    if (arrays.length === 1) {
+        return [...arrays[0]];
+    }
+    const [first, ...rest] = arrays;
+    const uniqueFirst = unique(first);
+    return uniqueFirst.filter(item => rest.every(array => array.includes(item)));
+};
+/**
+ * Returns elements from the first array that don't exist in the second array.
+ *
+ * @template T - The type of the items in the arrays.
+ *
+ * @param array - The source array.
+ * @param exclude - The array containing elements to exclude.
+ *
+ * @returns A new array with elements from the first array that don't exist in the second array.
+ *
+ * @example
+ * ```ts
+ * difference([1, 2, 3, 4], [2, 4]); // [1, 3]
+ * difference(['a', 'b', 'c'], ['b']); // ['a', 'c']
+ * ```
+ */
+const difference = (array, exclude) => array.filter(item => !exclude.includes(item));
 /***/ }),
@@ -76,8 +166,10 @@ const getTransformationValues = (element) => {
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   delay: () => (/* binding */ delay),
 /* harmony export */   invokeIfFunction: () => (/* binding */ invokeIfFunction),
-/* harmony export */   noop: () => (/* binding */ noop)
+/* harmony export */   noop: () => (/* binding */ noop),
+/* harmony export */   retry: () => (/* binding */ retry)
 /* harmony export */ });
 const noop = () => { };
 /**
@@ -93,6 +185,92 @@ const noop = () => { };
  * @returns The result of invoking the function, or the original value if it's not a function.
  */
 const invokeIfFunction = (input, ...args) => (typeof input === 'function' ? input(...args) : input);
+/**
+ * Creates a promise that resolves after the specified delay.
+ *
+ * Useful for creating artificial delays, implementing timeouts, or spacing operations.
+ *
+ * @param delayMs - The delay in milliseconds.
+ *
+ * @returns A promise that resolves after the specified delay.
+ *
+ * @example
+ * ```ts
+ * // Wait for 1 second
+ * await delay(1000);
+ * console.log('This logs after 1 second');
+ *
+ * // Use with other async operations
+ * async function fetchWithTimeout() {
+ *   const timeoutPromise = delay(5000).then(() => {
+ *     throw new Error('Request timed out');
+ *   });
+ *
+ *   return Promise.race([fetchData(), timeoutPromise]);
+ * }
+ * ```
+ */
+const delay = (delayMs) => new Promise(resolve => setTimeout(resolve, delayMs));
+/**
+ * Wraps an asynchronous function with retry logic.
+ *
+ * The returned function will attempt to call the original function up to `maxAttempts` times,
+ * with a delay between retries. If all attempts fail, the last encountered error is thrown.
+ *
+ * Useful for operations that may fail intermittently, such as network requests.
+ *
+ * @template Task - The type of the async function to wrap.
+ * @template TaskResult - The result type of the async function.
+ *
+ * @param task - The async function to wrap with retry logic.
+ * @param options - Configuration options for retry behavior.
+ *
+ * @returns A function that wraps the original function with retry support.
+ *
+ * @example
+ * ```ts
+ * async function fetchData() {
+ *   const response = await fetch('/api/data');
+ *
+ *   if (!response.ok) {
+ *    throw new Error('Network error');
+ *   }
+ *
+ *   return await response.json();
+ * }
+ *
+ * const fetchWithRetry = retry(fetchData, {
+ *   maxAttempts: 5,
+ *   delayMs: 500,
+ *   onRetry: (attempt, error) => {
+ *     console.warn(`Attempt ${attempt} failed:`, error);
+ *   }
+ * });
+ *
+ * fetchWithRetry()
+ *   .then(data => console.log('Success:', data))
+ *   .catch(error => console.error('Failed after retries:', error));
+ * ```
+ */
+const retry = (task, { maxAttempts = 3, delayMs = 300, backoff = true, onRetry } = {}) => {
+    return async (...args) => {
+        let lastError;
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            try {
+                return await task(...args);
+            }
+            catch (e) {
+                lastError = e;
+                if (attempt < maxAttempts) {
+                    onRetry?.(attempt, e);
+                    const delayTime = backoff ? delayMs * 2 ** (attempt - 1) : delayMs;
+                    await delay(delayTime);
+                }
+            }
+        }
+        throw lastError;
+    };
+};
 /***/ }),
@@ -105,6 +283,7 @@ const invokeIfFunction = (input, ...args) => (typeof input === 'function' ? inpu
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   assert: () => (/* binding */ assert),
 /* harmony export */   isArray: () => (/* binding */ isArray),
 /* harmony export */   isBool: () => (/* binding */ isBool),
 /* harmony export */   isDate: () => (/* binding */ isDate),
@@ -127,6 +306,11 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   isUndefined: () => (/* binding */ isUndefined),
 /* harmony export */   isValidDate: () => (/* binding */ isValidDate)
 /* harmony export */ });
+function assert(condition, message) {
+    if (!condition) {
+        throw new Error(message);
+    }
+}
 /**
  * Checks if a value is null.
  *
@@ -370,8 +554,53 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   splitStringIntoWords: () => (/* binding */ splitStringIntoWords),
 /* harmony export */   toKebabCase: () => (/* binding */ toKebabCase)
 /* harmony export */ });
+/**
+ * Converts a string to kebab-case format.
+ *
+ * This function transforms camelCase or PascalCase strings into kebab-case by inserting
+ * hyphens between lowercase and uppercase letters, then converting everything to lowercase.
+ *
+ * @param input - The string to convert to kebab-case.
+ *
+ * @returns The kebab-case formatted string.
+ *
+ * @example
+ * ```ts
+ * toKebabCase('helloWorld'); // → 'hello-world'
+ * toKebabCase('HelloWorld'); // → 'hello-world'
+ * toKebabCase('hello123World'); // → 'hello123-world'
+ * ```
+ */
 const toKebabCase = (input) => input.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
-const camelToDashCase = (input) => input.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);
+/**
+ * Converts a camelCase string to dash-case format.
+ *
+ * This function transforms camelCase strings into dash-case by inserting
+ * hyphens before uppercase letters and converting them to lowercase.
+ * The function ensures that no hyphen is added at the start of the output string,
+ * even if the input begins with an uppercase letter.
+ *
+ * @param input - The camelCase string to convert to dash-case.
+ *
+ * @returns The dash-case formatted string.
+ *
+ * @example
+ * ```ts
+ * camelToDashCase('helloWorld'); // → 'hello-world'
+ * camelToDashCase('HelloWorld'); // → 'hello-world'
+ * camelToDashCase('backgroundColor'); // → 'background-color'
+ * ```
+ */
+const camelToDashCase = (input) => {
+    // First handle the first character separately to avoid adding a hyphen at the start
+    const firstChar = input.charAt(0);
+    const restOfString = input.slice(1);
+    // Convert the first character to lowercase without adding a hyphen
+    const firstCharProcessed = firstChar.toLowerCase();
+    // Process the rest of the string normally, adding hyphens before uppercase letters
+    const restProcessed = restOfString.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);
+    return firstCharProcessed + restProcessed;
+};
 /**
  * Splits a string into an array of filtered from redundant spaces words.
  *
@@ -479,14 +708,18 @@ var __webpack_exports__ = {};
   \**********************/
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
-/* harmony export */   assert: () => (/* binding */ assert),
+/* harmony export */   assert: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_3__.assert),
 /* harmony export */   boolFilter: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.boolFilter),
 /* harmony export */   calculateEuclideanDistance: () => (/* reexport safe */ _math__WEBPACK_IMPORTED_MODULE_4__.calculateEuclideanDistance),
 /* harmony export */   calculateMovingSpeed: () => (/* reexport safe */ _math__WEBPACK_IMPORTED_MODULE_4__.calculateMovingSpeed),
 /* harmony export */   calculatePercentage: () => (/* reexport safe */ _math__WEBPACK_IMPORTED_MODULE_4__.calculatePercentage),
 /* harmony export */   camelToDashCase: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_0__.camelToDashCase),
+/* harmony export */   chunk: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.chunk),
+/* harmony export */   delay: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_2__.delay),
+/* harmony export */   difference: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.difference),
 /* harmony export */   getTransformationValues: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_5__.getTransformationValues),
 /* harmony export */   hashString: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_0__.hashString),
+/* harmony export */   intersection: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.intersection),
 /* harmony export */   invokeIfFunction: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_2__.invokeIfFunction),
 /* harmony export */   isArray: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_3__.isArray),
 /* harmony export */   isBool: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_3__.isBool),
@@ -510,8 +743,10 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   isUndefined: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_3__.isUndefined),
 /* harmony export */   isValidDate: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_3__.isValidDate),
 /* harmony export */   noop: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_2__.noop),
+/* harmony export */   retry: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_2__.retry),
 /* harmony export */   splitStringIntoWords: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_0__.splitStringIntoWords),
-/* harmony export */   toKebabCase: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_0__.toKebabCase)
+/* harmony export */   toKebabCase: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_0__.toKebabCase),
+/* harmony export */   unique: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.unique)
 /* harmony export */ });
 /* harmony import */ var _string__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./string */ "./src/string.ts");
 /* harmony import */ var _array__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./array */ "./src/array.ts");
@@ -525,11 +760,6 @@ __webpack_require__.r(__webpack_exports__);
-function assert(condition, message) {
-    if (!condition) {
-        throw new Error(message);
-    }
-}
 })();

package/dist/index.dev.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.dev.cjs","mappings":"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","sources":["webpack://@react-hive/honey-utils/./src/array.ts","webpack://@react-hive/honey-utils/./src/dom.ts","webpack://@react-hive/honey-utils/./src/function.ts","webpack://@react-hive/honey-utils/./src/guards.ts","webpack://@react-hive/honey-utils/./src/math.ts","webpack://@react-hive/honey-utils/./src/string.ts","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/index.ts"],"sourcesContent":["/*\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","interface HTMLElementTransformationValues {\n translateX: number;\n translateY: number;\n}\n\n/\n Get various transformation values from the transformation matrix of an element.\n \n @param element - The element with a transformation applied.\n \n @returns An object containing transformation values.\n /\nexport const getTransformationValues = (element: HTMLElement): HTMLElementTransformationValues => {\n const computedStyles = window.getComputedStyle(element);\n const transformValue = computedStyles.getPropertyValue('transform');\n\n const matrix = transformValue.match(/^matrix\$(.+)\$$/);\n if (!matrix) {\n return {\n translateX: 0,\n translateY: 0,\n };\n }\n\n const transformMatrix = matrix[1].split(', ');\n\n const translateX = parseFloat(transformMatrix[4]);\n const translateY = parseFloat(transformMatrix[5]);\n\n return {\n translateX,\n translateY,\n };\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 any[], Result>(\n input: ((...args: Args) => Result) \| Result,\n ...args: Args\n): Result => (typeof input === 'function' ? (input as (...args: Args) => Result)(...args) : input);\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","/\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","export const toKebabCase = (input: string): string =>\n input.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();\n\nexport const camelToDashCase = (input: string): string =>\n input.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);\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","// The module cache\nvar __webpack_module_cache__ = {};\n\n// The require function\nfunction __webpack_require__(moduleId) {\n\t// Check if module is in cache\n\tvar cachedModule = __webpack_module_cache__[moduleId];\n\tif (cachedModule !== undefined) {\n\t\treturn cachedModule.exports;\n\t}\n\t// Create a new module (and put it into the cache)\n\tvar module = __webpack_module_cache__[moduleId] = {\n\t\t// no module.id needed\n\t\t// no module.loaded needed\n\t\texports: {}\n\t};\n\n\t// Execute the module function\n\t__webpack_modules__[moduleId](module, module.exports, __webpack_require__);\n\n\t// Return the exports of the module\n\treturn module.exports;\n}\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};","export * from './string';\nexport * from './array';\nexport * from './function';\nexport * from './guards';\nexport * from './math';\nexport * from './dom';\n\nexport function assert(condition: any, message: string): asserts condition {\n if (!condition) {\n throw new Error(message);\n }\n}\n"],"names":[],"sourceRoot":""}
1	+ {"version":3,"file":"index.dev.cjs","mappings":";;;;;;;;;;;;;;;;;;;AAAkC;AAElC;;;;;;;;;;;GAWG;AACI,MAAM,UAAU,GAAG,CAAI,KAAuC,EAAO,EAAE,CAC5E,KAAK,CAAC,MAAM,CAAC,OAAO,CAAQ,CAAC;AAE/B;;;;;;;;;;;;;;;;GAgBG;AACI,MAAM,MAAM,GAAG,CAAI,KAAU,EAAO,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAElE;;;;;;;;;;;;;;;;;;GAkBG;AACI,MAAM,KAAK,GAAG,CAAI,KAAU,EAAE,IAAY,EAAS,EAAE;IAC1D,+CAAM,CAAC,IAAI,GAAG,CAAC,EAAE,mCAAmC,CAAC,CAAC;IAEtD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CACzE,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAC9C,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACI,MAAM,YAAY,GAAG,CAAI,GAAG,MAAa,EAAO,EAAE;IACvD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC;IAChC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAElC,OAAO,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACI,MAAM,UAAU,GAAG,CAAI,KAAU,EAAE,OAAY,EAAO,EAAE,CAC7D,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;ACzGhD;;;;;;GAMG;AACI,MAAM,uBAAuB,GAAG,CAAC,OAAoB,EAAmC,EAAE;IAC/F,MAAM,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,cAAc,GAAG,cAAc,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAEpE,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,CAAC;SACd,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE9C,MAAM,UAAU,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAElD,OAAO;QACL,UAAU;QACV,UAAU;KACX,CAAC;AACJ,CAAC,CAAC;;;;;;;;;;;;;;;;;;ACjCK,MAAM,IAAI,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;AAE7B;;;;;;;;;;;GAWG;AACI,MAAM,gBAAgB,GAAG,CAC9B,KAA2C,EAC3C,GAAG,IAAU,EACL,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAE,KAAmC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAEnG;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACI,MAAM,KAAK,GAAG,CAAC,OAAe,EAAiB,EAAE,CACtD,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAgCvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACI,MAAM,KAAK,GAAG,CACnB,IAAU,EACV,EAAE,WAAW,GAAG,CAAC,EAAE,OAAO,GAAG,GAAG,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,KAAmB,EAAE,EACxB,EAAE;IACxD,OAAO,KAAK,EAAE,GAAG,IAAsB,EAAuB,EAAE;QAC9D,IAAI,SAAkB,CAAC;QAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACxD,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,SAAS,GAAG,CAAC,CAAC;gBAEd,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;oBAC1B,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;oBAEtB,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;oBACnE,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,SAAS,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC9IK,SAAS,MAAM,CAAC,SAAc,EAAE,OAAe;IACpD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACI,MAAM,MAAM,GAAG,CAAC,KAAc,EAAiB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;AAExE;;;;;;GAMG;AACI,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;AAEvF;;;;;;GAMG;AACI,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;AAEvF;;;;;;GAMG;AACI,MAAM,MAAM,GAAG,CAAC,KAAc,EAAoB,EAAE,CAAC,OAAO,KAAK,KAAK,SAAS,CAAC;AAEvF;;;;;;GAMG;AACI,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;AAEvF;;;;;;GAMG;AACI,MAAM,aAAa,GAAG,CAAC,KAAc,EAAkC,EAAE,CAC9E,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AAEvE;;;;;;GAMG;AACI,MAAM,OAAO,GAAG,CAAC,KAAc,EAAsB,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEpF;;;;;;GAMG;AACI,MAAM,YAAY,GAAG,CAAC,KAAc,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;AAElG;;;;;;GAMG;AACI,MAAM,UAAU,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC;AAE1E;;;;;;;;GAQG;AACI,MAAM,SAAS,GAAG,CAAc,KAAc,EAAuB,EAAE,CAC5E,UAAU,CAAE,KAAoB,EAAE,IAAI,CAAC,CAAC;AAE1C;;;;;;GAMG;AACI,MAAM,KAAK,GAAG,CAAC,KAAc,EAA6B,EAAE,CACjE,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AAExC;;;;;;;;;;;GAWG;AACI,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAA6B,EAAE,CAC9E,KAAK,KAAK,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;AAE/B;;;;;;GAMG;AACI,MAAM,MAAM,GAAG,CAAC,KAAc,EAAiB,EAAE,CAAC,KAAK,YAAY,IAAI,CAAC;AAE/E;;;;;;GAMG;AACI,MAAM,WAAW,GAAG,CAAC,KAAc,EAAiB,EAAE,CAC3D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AAE3C;;;;;;GAMG;AACI,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,KAAK,YAAY,MAAM,CAAC;AAErF;;;;;;GAMG;AACI,MAAM,KAAK,GAAG,CAAC,KAAc,EAAkC,EAAE,CAAC,KAAK,YAAY,GAAG,CAAC;AAE9F;;;;;;GAMG;AACI,MAAM,KAAK,GAAG,CAAC,KAAc,EAAyB,EAAE,CAAC,KAAK,YAAY,GAAG,CAAC;AAErF;;;;;;GAMG;AACI,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;AAEvF;;;;;;GAMG;AACI,MAAM,WAAW,GAAG,CAAC,KAAc,EAAsB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;AAEvF;;;;;;GAMG;AACI,MAAM,cAAc,GAAG,CAAC,KAAc,EAAmB,EAAE,CAChE,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC;AAErC;;;;;;GAMG;AACI,MAAM,SAAS,GAAG,CAAC,KAAc,EAAmB,EAAE,CAC3D,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;;;;;;;;;;;;;;;;;AC/M7C;;;;;;;;;GASG;AACI,MAAM,0BAA0B,GAAG,CACxC,MAAc,EACd,MAAc,EACd,IAAY,EACZ,IAAY,EACJ,EAAE;IACV,MAAM,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;IAE7B,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF;;;;;;;GAOG;AACI,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAE,WAAmB,EAAU,EAAE,CACjF,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC,CAAC;AAEhC;;;;;;;GAOG;AACI,MAAM,mBAAmB,GAAG,CAAC,KAAa,EAAE,UAAkB,EAAU,EAAE;IAC/E,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC;AACpC,CAAC,CAAC;;;;;;;;;;;;;;;;;;AC3CF;;;;;;;;;;;;;;;;GAgBG;AACI,MAAM,WAAW,GAAG,CAAC,KAAa,EAAU,EAAE,CACnD,KAAK,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AAE7D;;;;;;;;;;;;;;;;;;GAkBG;AACI,MAAM,eAAe,GAAG,CAAC,KAAa,EAAU,EAAE;IACvD,oFAAoF;IACpF,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEpC,mEAAmE;IACnE,MAAM,kBAAkB,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAEnD,mFAAmF;IACnF,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAE3F,OAAO,kBAAkB,GAAG,aAAa,CAAC;AAC5C,CAAC,CAAC;AAEF;;;;;;GAMG;AACI,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAY,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAElG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE;IAClD,IAAI,IAAI,GAAG,IAAI,CAAC;IAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACnC,CAAC,CAAC;;;;;;;UC9FF;UACA;;UAEA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;;UAEA;UACA;;UAEA;UACA;UACA;;;;;WCtBA;WACA;WACA;WACA;WACA,yCAAyC,wCAAwC;WACjF;WACA;WACA,E;;;;;WCPA,wF;;;;;WCAA;WACA;WACA;WACA,uDAAuD,iBAAiB;WACxE;WACA,gDAAgD,aAAa;WAC7D,E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACNyB;AACD;AACG;AACF;AACF;AACD","sources":["webpack://@react-hive/honey-utils/./src/array.ts","webpack://@react-hive/honey-utils/./src/dom.ts","webpack://@react-hive/honey-utils/./src/function.ts","webpack://@react-hive/honey-utils/./src/guards.ts","webpack://@react-hive/honey-utils/./src/math.ts","webpack://@react-hive/honey-utils/./src/string.ts","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/index.ts"],"sourcesContent":["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","interface HTMLElementTransformationValues {\n translateX: number;\n translateY: number;\n}\n\n/\n Get various transformation values from the transformation matrix of an element.\n \n @param element - The element with a transformation applied.\n \n @returns An object containing transformation values.\n /\nexport const getTransformationValues = (element: HTMLElement): HTMLElementTransformationValues => {\n const computedStyles = window.getComputedStyle(element);\n const transformValue = computedStyles.getPropertyValue('transform');\n\n const matrix = transformValue.match(/^matrix\$(.+)\$$/);\n if (!matrix) {\n return {\n translateX: 0,\n translateY: 0,\n };\n }\n\n const transformMatrix = matrix[1].split(', ');\n\n const translateX = parseFloat(transformMatrix[4]);\n const translateY = parseFloat(transformMatrix[5]);\n\n return {\n translateX,\n translateY,\n };\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","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","/\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","/*\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","// The module cache\nvar __webpack_module_cache__ = {};\n\n// The require function\nfunction __webpack_require__(moduleId) {\n\t// Check if module is in cache\n\tvar cachedModule = __webpack_module_cache__[moduleId];\n\tif (cachedModule !== undefined) {\n\t\treturn cachedModule.exports;\n\t}\n\t// Create a new module (and put it into the cache)\n\tvar module = __webpack_module_cache__[moduleId] = {\n\t\t// no module.id needed\n\t\t// no module.loaded needed\n\t\texports: {}\n\t};\n\n\t// Execute the module function\n\t__webpack_modules__[moduleId](module, module.exports, __webpack_require__);\n\n\t// Return the exports of the module\n\treturn module.exports;\n}\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};","export * from './string';\nexport * from './array';\nexport * from './function';\nexport * from './guards';\nexport * from './math';\nexport * from './dom';\n"],"names":[],"sourceRoot":""}

package/dist/index.mjs CHANGED Viewed

@@ -1,2 +1,2 @@
-const t=t=>t.replace(/([a-z0-9])([A-Z])/g,"$1-$2").toLowerCase(),e=t=>t.replace(/[A-Z]/g,t=>`-${t.toLowerCase()}`),n=t=>t.split(" ").filter(Boolean),o=t=>{let e=5381;for(let n=0;n<t.length;n++)e=33*e^t.charCodeAt(n);return(e>>>0).toString(36)},r=t=>t.filter(Boolean),a=()=>{},s=(t,...e)=>"function"==typeof t?t(...e):t,l=t=>null===t,i=t=>"string"==typeof t,f=t=>"number"==typeof t,p=t=>"boolean"==typeof t,c=t=>"object"==typeof t,u=t=>c(t)&&!l(t)&&0===Object.keys(t).length,y=t=>Array.isArray(t),g=t=>y(t)&&0===t.length,h=t=>"function"==typeof t,m=t=>h(t?.then),b=t=>null==t,w=t=>""===t||b(t),A=t=>t instanceof Date,d=t=>A(t)&&!isNaN(t.getTime()),C=t=>t instanceof RegExp,$=t=>t instanceof Map,x=t=>t instanceof Set,F=t=>"symbol"==typeof t,M=t=>void 0===t,N=t=>f(t)&&isFinite(t),S=t=>f(t)&&Number.isInteger(t),j=(t,e,n,o)=>{const r=n-t,a=o-e;return Math.sqrt(r**2+a**2)},B=(t,e)=>Math.abs(t/e),E=(t,e)=>t*e/100,L=t=>{const e=window.getComputedStyle(t).getPropertyValue("transform").match(/^matrix\((.+)\)$/);if(!e)return{translateX:0,translateY:0};const n=e[1].split(", ");return{translateX:parseFloat(n[4]),translateY:parseFloat(n[5])}};function X(t,e){if(!t)throw new Error(e)}export{X as assert,r as boolFilter,j as calculateEuclideanDistance,B as calculateMovingSpeed,E as calculatePercentage,e as camelToDashCase,L as getTransformationValues,o as hashString,s as invokeIfFunction,y as isArray,p as isBool,A as isDate,g as isEmptyArray,u as isEmptyObject,N as isFiniteNumber,h as isFunction,S as isInteger,$ as isMap,b as isNil,w as isNilOrEmptyString,l as isNull,f as isNumber,c as isObject,m as isPromise,C as isRegExp,x as isSet,i as isString,F as isSymbol,M as isUndefined,d as isValidDate,a as noop,n as splitStringIntoWords,t as toKebabCase};
+const t=t=>t.replace(/([a-z0-9])([A-Z])/g,"$1-$2").toLowerCase(),e=t=>{const e=t.charAt(0),r=t.slice(1);return e.toLowerCase()+r.replace(/[A-Z]/g,t=>`-${t.toLowerCase()}`)},r=t=>t.split(" ").filter(Boolean),n=t=>{let e=5381;for(let r=0;r<t.length;r++)e=33*e^t.charCodeAt(r);return(e>>>0).toString(36)};function o(t,e){if(!t)throw new Error(e)}const a=t=>null===t,s=t=>"string"==typeof t,l=t=>"number"==typeof t,i=t=>"boolean"==typeof t,c=t=>"object"==typeof t,f=t=>c(t)&&!a(t)&&0===Object.keys(t).length,u=t=>Array.isArray(t),h=t=>u(t)&&0===t.length,p=t=>"function"==typeof t,y=t=>p(t?.then),g=t=>null==t,m=t=>""===t||g(t),w=t=>t instanceof Date,b=t=>w(t)&&!isNaN(t.getTime()),A=t=>t instanceof RegExp,d=t=>t instanceof Map,C=t=>t instanceof Set,M=t=>"symbol"==typeof t,x=t=>void 0===t,S=t=>l(t)&&isFinite(t),$=t=>l(t)&&Number.isInteger(t),k=t=>t.filter(Boolean),F=t=>[...new Set(t)],L=(t,e)=>(o(e>0,"Chunk size must be greater than 0"),Array.from({length:Math.ceil(t.length/e)},(r,n)=>t.slice(n*e,(n+1)*e))),N=(...t)=>{if(0===t.length)return[];if(1===t.length)return[...t[0]];const[e,...r]=t;return F(e).filter(t=>r.every(e=>e.includes(t)))},j=(t,e)=>t.filter(t=>!e.includes(t)),v=()=>{},z=(t,...e)=>"function"==typeof t?t(...e):t,B=t=>new Promise(e=>setTimeout(e,t)),E=(t,{maxAttempts:e=3,delayMs:r=300,backoff:n=!0,onRetry:o}={})=>async(...a)=>{let s;for(let l=1;l<=e;l++)try{return await t(...a)}catch(t){if(s=t,l<e){o?.(l,t);const e=n?r*2**(l-1):r;await B(e)}}throw s},P=(t,e,r,n)=>{const o=r-t,a=n-e;return Math.sqrt(o**2+a**2)},R=(t,e)=>Math.abs(t/e),T=(t,e)=>t*e/100,X=t=>{const e=window.getComputedStyle(t).getPropertyValue("transform").match(/^matrix\((.+)\)$/);if(!e)return{translateX:0,translateY:0};const r=e[1].split(", ");return{translateX:parseFloat(r[4]),translateY:parseFloat(r[5])}};export{o as assert,k as boolFilter,P as calculateEuclideanDistance,R as calculateMovingSpeed,T as calculatePercentage,e as camelToDashCase,L as chunk,B as delay,j as difference,X as getTransformationValues,n as hashString,N as intersection,z as invokeIfFunction,u as isArray,i as isBool,w as isDate,h as isEmptyArray,f as isEmptyObject,S as isFiniteNumber,p as isFunction,$ as isInteger,d as isMap,g as isNil,m as isNilOrEmptyString,a as isNull,l as isNumber,c as isObject,y as isPromise,A as isRegExp,C as isSet,s as isString,M as isSymbol,x as isUndefined,b as isValidDate,v as noop,E as retry,r as splitStringIntoWords,t as toKebabCase,F as unique};
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.mjs","mappings":"AAAO,MAAMA,EAAeC,GAC1BA,EAAMC,QAAQ,qBAAsB,SAASC,cAElCC,EAAmBH,GAC9BA,EAAMC,QAAQ,SAAUG,GAAU,IAAIA,EAAOF,iBASlCG,EAAwBL,GAA4BA,EAAMM,MAAM,KAAKC,OAAOC,SA0B5EC,EAAcT,IACzB,IAAIU,EAAO,KAEX,IAAK,IAAIC,EAAI,EAAGA,EAAIX,EAAMY,OAAQD,IAChCD,EAAe,GAAPA,EAAaV,EAAMa,WAAWF,GAGxC,OAAQD,IAAS,GAAGI,SAAS,KClClBC,EAAiBC,GAC5BA,EAAMT,OAAOC,SCbFS,EAAO,OAcPC,EAAmB,CAC9BlB,KACGmB,IAC0B,mBAAVnB,EAAwBA,KAAuCmB,GAAQnB,ECV/EoB,EAAUC,GAA4C,OAAVA,EAS5CC,EAAYD,GAAqD,iBAAVA,EASvDE,EAAYF,GAAqD,iBAAVA,EASvDG,EAAUH,GAAsD,kBAAVA,EAStDI,EAAYJ,GAAqD,iBAAVA,EASvDK,EAAiBL,GAC5BI,EAASJ,KAAWD,EAAOC,IAAwC,IAA9BM,OAAOC,KAAKP,GAAOT,OAS7CiB,EAAWR,GAAuCS,MAAMD,QAAQR,GAShEU,EAAgBV,GAAgCQ,EAAQR,IAA2B,IAAjBA,EAAMT,OASxEoB,EAAcX,GAAoC,mBAAVA,EAWxCY,EAA0BZ,GACrCW,EAAYX,GAAsBa,MASvBC,EAASd,GACpBA,QAcWe,EAAsBf,GACvB,KAAVA,GAAgBc,EAAMd,GASXgB,EAAUhB,GAAkCA,aAAiBiB,KAS7DC,EAAelB,GAC1BgB,EAAOhB,KAAWmB,MAAMnB,EAAMoB,WASnBC,EAAYrB,GAAoCA,aAAiBsB,OASjEC,EAASvB,GAAmDA,aAAiBwB,IAS7EC,EAASzB,GAA0CA,aAAiB0B,IASpEC,EAAY3B,GAAqD,iBAAVA,EASvD4B,EAAe5B,QAAiD6B,IAAV7B,EAStD8B,EAAkB9B,GAC7BE,EAASF,IAAU+B,SAAS/B,GASjBgC,EAAahC,GACxBE,EAASF,IAAUiC,OAAOD,UAAUhC,GC/LzBkC,EAA6B,CACxCC,EACAC,EACAC,EACAC,KAEA,MAAMC,EAASF,EAAOF,EAChBK,EAASF,EAAOF,EAEtB,OAAOK,KAAKC,KAAKH,GAAU,EAAIC,GAAU,IAW9BG,EAAuB,CAACC,EAAeC,IAClDJ,KAAKK,IAAIF,EAAQC,GAUNE,EAAsB,CAAC/C,EAAegD,IACzChD,EAAQgD,EAAc,IC9BnBC,EAA2BC,IACtC,MAGMC,EAHiBC,OAAOC,iBAAiBH,GACTI,iBAAiB,aAEzBC,MAAM,oBACpC,IAAKJ,EACH,MAAO,CACLK,WAAY,EACZC,WAAY,GAIhB,MAAMC,EAAkBP,EAAO,GAAGlE,MAAM,MAKxC,MAAO,CACLuE,WAJiBG,WAAWD,EAAgB,IAK5CD,WAJiBE,WAAWD,EAAgB,MCpBzC,SAASE,EAAOC,EAAgBC,GACrC,IAAKD,EACH,MAAM,IAAIE,MAAMD,EAEpB,Q","sources":["webpack://@react-hive/honey-utils/./src/string.ts","webpack://@react-hive/honey-utils/./src/array.ts","webpack://@react-hive/honey-utils/./src/function.ts","webpack://@react-hive/honey-utils/./src/guards.ts","webpack://@react-hive/honey-utils/./src/math.ts","webpack://@react-hive/honey-utils/./src/dom.ts","webpack://@react-hive/honey-utils/./src/index.ts"],"sourcesContent":["export const toKebabCase = (input: string): string =>\n input.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();\n\nexport const camelToDashCase = (input: string): string =>\n input.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);\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","/*\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","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 any[], Result>(\n input: ((...args: Args) => Result) \| Result,\n ...args: Args\n): Result => (typeof input === 'function' ? (input as (...args: Args) => Result)(...args) : input);\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","/\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}\n\n/*\n Get various transformation values from the transformation matrix of an element.\n \n @param element - The element with a transformation applied.\n \n @returns An object containing transformation values.\n /\nexport const getTransformationValues = (element: HTMLElement): HTMLElementTransformationValues => {\n const computedStyles = window.getComputedStyle(element);\n const transformValue = computedStyles.getPropertyValue('transform');\n\n const matrix = transformValue.match(/^matrix\$(.+)\$$/);\n if (!matrix) {\n return {\n translateX: 0,\n translateY: 0,\n };\n }\n\n const transformMatrix = matrix[1].split(', ');\n\n const translateX = parseFloat(transformMatrix[4]);\n const translateY = parseFloat(transformMatrix[5]);\n\n return {\n translateX,\n translateY,\n };\n};\n","export from './string';\nexport * from './array';\nexport * from './function';\nexport * from './guards';\nexport * from './math';\nexport * from './dom';\n\nexport function assert(condition: any, message: string): asserts condition {\n if (!condition) {\n throw new Error(message);\n }\n}\n"],"names":["toKebabCase","input","replace","toLowerCase","camelToDashCase","letter","splitStringIntoWords","split","filter","Boolean","hashString","hash","i","length","charCodeAt","toString","boolFilter","array","noop","invokeIfFunction","args","isNull","value","isString","isNumber","isBool","isObject","isEmptyObject","Object","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","calculateEuclideanDistance","startX","startY","endX","endY","deltaX","deltaY","Math","sqrt","calculateMovingSpeed","delta","elapsedTime","abs","calculatePercentage","percentage","getTransformationValues","element","matrix","window","getComputedStyle","getPropertyValue","match","translateX","translateY","transformMatrix","parseFloat","assert","condition","message","Error"],"sourceRoot":""}
1	+ {"version":3,"file":"index.mjs","mappings":"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","sources":["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":["/*\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","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}\n\n/*\n Get various transformation values from the transformation matrix of an element.\n \n @param element - The element with a transformation applied.\n \n @returns An object containing transformation values.\n */\nexport const getTransformationValues = (element: HTMLElement): HTMLElementTransformationValues => {\n const computedStyles = window.getComputedStyle(element);\n const transformValue = computedStyles.getPropertyValue('transform');\n\n const matrix = transformValue.match(/^matrix\$(.+)\$$/);\n if (!matrix) {\n return {\n translateX: 0,\n translateY: 0,\n };\n }\n\n const transformMatrix = matrix[1].split(', ');\n\n const translateX = parseFloat(transformMatrix[4]);\n const translateY = parseFloat(transformMatrix[5]);\n\n return {\n translateX,\n translateY,\n };\n};\n"],"names":["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","value","isString","isNumber","isBool","isObject","isEmptyObject","Object","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","noop","invokeIfFunction","args","delay","delayMs","Promise","resolve","setTimeout","retry","task","maxAttempts","backoff","onRetry","async","lastError","attempt","e","delayTime","calculateEuclideanDistance","startX","startY","endX","endY","deltaX","deltaY","sqrt","calculateMovingSpeed","delta","elapsedTime","abs","calculatePercentage","percentage","getTransformationValues","element","matrix","window","getComputedStyle","getPropertyValue","match","translateX","translateY","transformMatrix","parseFloat"],"sourceRoot":""}

package/dist/string.d.ts CHANGED Viewed

@@ -1,4 +1,40 @@
+/**
+ * Converts a string to kebab-case format.
+ *
+ * This function transforms camelCase or PascalCase strings into kebab-case by inserting
+ * hyphens between lowercase and uppercase letters, then converting everything to lowercase.
+ *
+ * @param input - The string to convert to kebab-case.
+ *
+ * @returns The kebab-case formatted string.
+ *
+ * @example
+ * ```ts
+ * toKebabCase('helloWorld'); // → 'hello-world'
+ * toKebabCase('HelloWorld'); // → 'hello-world'
+ * toKebabCase('hello123World'); // → 'hello123-world'
+ * ```
+ */
 export declare const toKebabCase: (input: string) => string;
+/**
+ * Converts a camelCase string to dash-case format.
+ *
+ * This function transforms camelCase strings into dash-case by inserting
+ * hyphens before uppercase letters and converting them to lowercase.
+ * The function ensures that no hyphen is added at the start of the output string,
+ * even if the input begins with an uppercase letter.
+ *
+ * @param input - The camelCase string to convert to dash-case.
+ *
+ * @returns The dash-case formatted string.
+ *
+ * @example
+ * ```ts
+ * camelToDashCase('helloWorld'); // → 'hello-world'
+ * camelToDashCase('HelloWorld'); // → 'hello-world'
+ * camelToDashCase('backgroundColor'); // → 'background-color'
+ * ```
+ */
 export declare const camelToDashCase: (input: string) => string;
 /**
  * Splits a string into an array of filtered from redundant spaces words.

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@react-hive/honey-utils",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "A lightweight TypeScript utility library providing a collection of helper functions for common programming tasks",
   "keywords": [
     "utils",