@react-hive/honey-utils 3.27.0 → 3.30.0

package/dist/index.dev.cjs

@@ -212,42 +212,55 @@ __webpack_require__.r(__webpack_exports__);
 
 /***/ },
 
-/***/ "./src/array.ts"
-/*!**********************!*\
-  !*** ./src/array.ts ***!
-  \**********************/
+/***/ "./src/array/chunk.ts"
+/*!****************************!*\
+  !*** ./src/array/chunk.ts ***!
+  \****************************/
 (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
 
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
-/* harmony export */   chunk: () => (/* binding */ chunk),
-/* harmony export */   compact: () => (/* binding */ compact),
-/* harmony export */   compose: () => (/* binding */ compose),
-/* harmony export */   difference: () => (/* binding */ difference),
-/* harmony export */   intersection: () => (/* binding */ intersection),
-/* harmony export */   isArray: () => (/* binding */ isArray),
-/* harmony export */   isEmptyArray: () => (/* binding */ isEmptyArray),
-/* harmony export */   pipe: () => (/* binding */ pipe),
-/* harmony export */   unique: () => (/* binding */ unique)
+/* harmony export */   chunk: () => (/* binding */ chunk)
 /* harmony export */ });
 /* harmony import */ var _guards__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ~/guards */ "./src/guards.ts");
 
 /**
- * Checks if a value is an array.
+ * Splits an array into chunks of the specified size.
  *
- * @param value - The value to check.
+ * Useful for pagination, batch processing, or creating grid layouts.
  *
- * @returns `true` if the value is an array; otherwise, `false`.
- */
-const isArray = (value) => Array.isArray(value);
-/**
- * Checks if a value is an empty array.
+ * @template T - The type of the items in the array.
  *
- * @param value - The value to check.
+ * @param array - The input array to be chunked.
+ * @param size - The size of each chunk. Must be greater than 0.
  *
- * @returns `true` if the value is an empty array; otherwise, `false`.
+ * @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 isEmptyArray = (value) => isArray(value) && value.length === 0;
+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));
+};
+
+
+/***/ },
+
+/***/ "./src/array/compact.ts"
+/*!******************************!*\
+  !*** ./src/array/compact.ts ***!
+  \******************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   compact: () => (/* binding */ compact)
+/* harmony export */ });
 /**
  * Removes all falsy values from an array.
  *
@@ -267,47 +280,176 @@ const isEmptyArray = (value) => isArray(value) && value.length === 0;
  * ```
  */
 const compact = (array) => array.filter(Boolean);
+
+
+/***/ },
+
+/***/ "./src/array/compose.ts"
+/*!******************************!*\
+  !*** ./src/array/compose.ts ***!
+  \******************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   compose: () => (/* binding */ compose)
+/* harmony export */ });
 /**
- * Returns a new array with duplicate values removed.
- *
- * Uses Set for efficient duplicate removal while preserving the original order.
+ * Composes multiple unary functions into a single function, applying them from **right to left**.
  *
- * @template T - The type of the items in the array.
+ * Often used for building functional pipelines where the innermost function runs first.
+ * Types are inferred up to 5 chained functions for full type safety.
  *
- * @param array - The input array that may contain duplicate values.
+ * @param fns - A list of unary functions to compose.
  *
- * @returns A new array with only unique values, maintaining the original order.
+ * @returns A new function that applies all functions from right to left.
  *
  * @example
  * ```ts
- * unique([1, 2, 2, 3, 1, 4]); // [1, 2, 3, 4]
- * unique(['a', 'b', 'a', 'c']); // ['a', 'b', 'c']
+ * const add = (x: number) => x + 1;
+ * const double = (x: number) => x * 2;
+ * const toStr = (x: number) => `Result: ${x}`;
+ *
+ * const result = compose(toStr, double, add)(2);
+ * // => 'Result: 6'
  * ```
  */
-const unique = (array) => [...new Set(array)];
+const compose = (...fns) => (arg) => fns.reduceRight((prev, fn) => fn(prev), arg);
+
+
+/***/ },
+
+/***/ "./src/array/difference.ts"
+/*!*********************************!*\
+  !*** ./src/array/difference.ts ***!
+  \*********************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   difference: () => (/* binding */ difference)
+/* harmony export */ });
 /**
- * Splits an array into chunks of the specified size.
- *
- * Useful for pagination, batch processing, or creating grid layouts.
+ * Returns elements from the first array that don't exist in the second array.
  *
- * @template T - The type of the items in the array.
+ * @template T - The type of the items in the arrays.
  *
- * @param array - The input array to be chunked.
- * @param size - The size of each chunk. Must be greater than 0.
+ * @param array - The source array.
+ * @param exclude - The array containing elements to exclude.
  *
- * @returns An array of chunks, where each chunk is an array of the specified size
- *          (except possibly the last chunk, which may be smaller).
+ * @returns A new array with elements from the first array that don't exist in the second array.
  *
  * @example
  * ```ts
- * chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
- * chunk(['a', 'b', 'c', 'd'], 3); // [['a', 'b', 'c'], ['d']]
+ * difference([1, 2, 3, 4], [2, 4]); // [1, 3]
+ * difference(['a', 'b', 'c'], ['b']); // ['a', 'c']
  * ```
  */
-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));
+const difference = (array, exclude) => array.filter(item => !exclude.includes(item));
+
+
+/***/ },
+
+/***/ "./src/array/get-adjacent-items.ts"
+/*!*****************************************!*\
+  !*** ./src/array/get-adjacent-items.ts ***!
+  \*****************************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   getAdjacentItems: () => (/* binding */ getAdjacentItems)
+/* harmony export */ });
+/**
+ * Returns previous, current, and next items for the matched item.
+ *
+ * @param items - Source items.
+ * @param targetItem - Item to find in the source array.
+ * @param isSameItem - Comparator used to match items.
+ *
+ * @returns Adjacent items around the matched item.
+ */
+const getAdjacentItems = (items, targetItem, isSameItem) => {
+    if (!items?.length || !targetItem) {
+        return {
+            previousItem: null,
+            currentItem: null,
+            nextItem: null,
+        };
+    }
+    const currentItemIndex = items.findIndex(item => isSameItem(item, targetItem));
+    if (currentItemIndex === -1) {
+        return {
+            previousItem: null,
+            currentItem: null,
+            nextItem: null,
+        };
+    }
+    return {
+        previousItem: currentItemIndex > 0 ? items[currentItemIndex - 1] : null,
+        currentItem: items[currentItemIndex],
+        nextItem: currentItemIndex < items.length - 1 ? items[currentItemIndex + 1] : null,
+    };
 };
+
+
+/***/ },
+
+/***/ "./src/array/index.ts"
+/*!****************************!*\
+  !*** ./src/array/index.ts ***!
+  \****************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   chunk: () => (/* reexport safe */ _chunk__WEBPACK_IMPORTED_MODULE_4__.chunk),
+/* harmony export */   compact: () => (/* reexport safe */ _compact__WEBPACK_IMPORTED_MODULE_6__.compact),
+/* harmony export */   compose: () => (/* reexport safe */ _compose__WEBPACK_IMPORTED_MODULE_1__.compose),
+/* harmony export */   difference: () => (/* reexport safe */ _difference__WEBPACK_IMPORTED_MODULE_2__.difference),
+/* harmony export */   getAdjacentItems: () => (/* reexport safe */ _get_adjacent_items__WEBPACK_IMPORTED_MODULE_9__.getAdjacentItems),
+/* harmony export */   intersection: () => (/* reexport safe */ _intersection__WEBPACK_IMPORTED_MODULE_3__.intersection),
+/* harmony export */   isArray: () => (/* reexport safe */ _is_array__WEBPACK_IMPORTED_MODULE_7__.isArray),
+/* harmony export */   isEmptyArray: () => (/* reexport safe */ _is_empty_array__WEBPACK_IMPORTED_MODULE_8__.isEmptyArray),
+/* harmony export */   pipe: () => (/* reexport safe */ _pipe__WEBPACK_IMPORTED_MODULE_0__.pipe),
+/* harmony export */   unique: () => (/* reexport safe */ _unique__WEBPACK_IMPORTED_MODULE_5__.unique)
+/* harmony export */ });
+/* harmony import */ var _pipe__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./pipe */ "./src/array/pipe.ts");
+/* harmony import */ var _compose__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./compose */ "./src/array/compose.ts");
+/* harmony import */ var _difference__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./difference */ "./src/array/difference.ts");
+/* harmony import */ var _intersection__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./intersection */ "./src/array/intersection.ts");
+/* harmony import */ var _chunk__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ./chunk */ "./src/array/chunk.ts");
+/* harmony import */ var _unique__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ./unique */ "./src/array/unique.ts");
+/* harmony import */ var _compact__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ./compact */ "./src/array/compact.ts");
+/* harmony import */ var _is_array__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ./is-array */ "./src/array/is-array.ts");
+/* harmony import */ var _is_empty_array__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ./is-empty-array */ "./src/array/is-empty-array.ts");
+/* harmony import */ var _get_adjacent_items__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(/*! ./get-adjacent-items */ "./src/array/get-adjacent-items.ts");
+
+
+
+
+
+
+
+
+
+
+
+
+/***/ },
+
+/***/ "./src/array/intersection.ts"
+/*!***********************************!*\
+  !*** ./src/array/intersection.ts ***!
+  \***********************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   intersection: () => (/* binding */ intersection)
+/* harmony export */ });
+/* harmony import */ var _array__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ~/array */ "./src/array/index.ts");
+
 /**
  * Returns an array containing elements that exist in all provided arrays.
  *
@@ -331,26 +473,69 @@ const intersection = (...arrays) => {
         return [...arrays[0]];
     }
     const [first, ...rest] = arrays;
-    const uniqueFirst = unique(first);
+    const uniqueFirst = (0,_array__WEBPACK_IMPORTED_MODULE_0__.unique)(first);
     return uniqueFirst.filter(item => rest.every(array => array.includes(item)));
 };
+
+
+/***/ },
+
+/***/ "./src/array/is-array.ts"
+/*!*******************************!*\
+  !*** ./src/array/is-array.ts ***!
+  \*******************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   isArray: () => (/* binding */ isArray)
+/* harmony export */ });
 /**
- * Returns elements from the first array that don't exist in the second array.
+ * Checks if a value is an array.
  *
- * @template T - The type of the items in the arrays.
+ * @param value - The value to check.
  *
- * @param array - The source array.
- * @param exclude - The array containing elements to exclude.
+ * @returns `true` if the value is an array; otherwise, `false`.
+ */
+const isArray = (value) => Array.isArray(value);
+
+
+/***/ },
+
+/***/ "./src/array/is-empty-array.ts"
+/*!*************************************!*\
+  !*** ./src/array/is-empty-array.ts ***!
+  \*************************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   isEmptyArray: () => (/* binding */ isEmptyArray)
+/* harmony export */ });
+/* harmony import */ var _array__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ~/array */ "./src/array/index.ts");
+
+/**
+ * Checks if a value is an empty array.
  *
- * @returns A new array with elements from the first array that don't exist in the second array.
+ * @param value - The value to check.
  *
- * @example
- * ```ts
- * difference([1, 2, 3, 4], [2, 4]); // [1, 3]
- * difference(['a', 'b', 'c'], ['b']); // ['a', 'c']
- * ```
+ * @returns `true` if the value is an empty array; otherwise, `false`.
  */
-const difference = (array, exclude) => array.filter(item => !exclude.includes(item));
+const isEmptyArray = (value) => (0,_array__WEBPACK_IMPORTED_MODULE_0__.isArray)(value) && value.length === 0;
+
+
+/***/ },
+
+/***/ "./src/array/pipe.ts"
+/*!***************************!*\
+  !*** ./src/array/pipe.ts ***!
+  \***************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   pipe: () => (/* binding */ pipe)
+/* harmony export */ });
 /**
  * Composes multiple unary functions into a single function, applying them from left to right.
  *
@@ -373,27 +558,38 @@ const difference = (array, exclude) => array.filter(item => !exclude.includes(it
  * ```
  */
 const pipe = (...fns) => (arg) => fns.reduce((prev, fn) => fn(prev), arg);
+
+
+/***/ },
+
+/***/ "./src/array/unique.ts"
+/*!*****************************!*\
+  !*** ./src/array/unique.ts ***!
+  \*****************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   unique: () => (/* binding */ unique)
+/* harmony export */ });
 /**
- * Composes multiple unary functions into a single function, applying them from **right to left**.
+ * Returns a new array with duplicate values removed.
  *
- * Often used for building functional pipelines where the innermost function runs first.
- * Types are inferred up to 5 chained functions for full type safety.
+ * Uses Set for efficient duplicate removal while preserving the original order.
  *
- * @param fns - A list of unary functions to compose.
+ * @template T - The type of the items in the array.
  *
- * @returns A new function that applies all functions from right to left.
+ * @param array - The input array that may contain duplicate values.
+ *
+ * @returns A new array with only unique values, maintaining the original order.
  *
  * @example
  * ```ts
- * const add = (x: number) => x + 1;
- * const double = (x: number) => x * 2;
- * const toStr = (x: number) => `Result: ${x}`;
- *
- * const result = compose(toStr, double, add)(2);
- * // => 'Result: 6'
+ * unique([1, 2, 2, 3, 1, 4]); // [1, 2, 3, 4]
+ * unique(['a', 'b', 'a', 'c']); // ['a', 'b', 'c']
  * ```
  */
-const compose = (...fns) => (arg) => fns.reduceRight((prev, fn) => fn(prev), arg);
+const unique = (array) => [...new Set(array)];
 
 
 /***/ },
@@ -416,7 +612,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   runSequential: () => (/* binding */ runSequential),
 /* harmony export */   someAsync: () => (/* binding */ someAsync)
 /* harmony export */ });
-/* harmony import */ var _array__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ~/array */ "./src/array.ts");
+/* harmony import */ var _array__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ~/array */ "./src/array/index.ts");
 /* harmony import */ var _function__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ~/function */ "./src/function/index.ts");
 
 
@@ -3382,6 +3578,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   flattenTree: () => (/* reexport safe */ _tree__WEBPACK_IMPORTED_MODULE_14__.flattenTree),
 /* harmony export */   forEachChar: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_13__.forEachChar),
 /* harmony export */   generateEphemeralId: () => (/* reexport safe */ _id__WEBPACK_IMPORTED_MODULE_9__.generateEphemeralId),
+/* harmony export */   getAdjacentItems: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.getAdjacentItems),
 /* harmony export */   getDOMRectIntersectionRatio: () => (/* reexport safe */ _intersection__WEBPACK_IMPORTED_MODULE_10__.getDOMRectIntersectionRatio),
 /* harmony export */   getDataTransferJson: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_3__.getDataTransferJson),
 /* harmony export */   getElementOffsetRect: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_3__.getElementOffsetRect),
@@ -3452,7 +3649,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   unique: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.unique)
 /* harmony export */ });
 /* harmony import */ var _a11y__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./a11y */ "./src/a11y/index.ts");
-/* harmony import */ var _array__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./array */ "./src/array.ts");
+/* harmony import */ var _array__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./array */ "./src/array/index.ts");
 /* harmony import */ var _async__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./async */ "./src/async/index.ts");
 /* harmony import */ var _dom__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./dom */ "./src/dom/index.ts");
 /* harmony import */ var _env__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ./env */ "./src/env/index.ts");