@react-hive/honey-utils 3.0.0 → 3.2.0

package/dist/index.dev.cjs

@@ -15,11 +15,29 @@ __webpack_require__.r(__webpack_exports__);
 /* 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 */ });
 /* harmony import */ var _guards__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./guards */ "./src/guards.ts");
 
+/**
+ * Checks if a value is an array.
+ *
+ * @param value - The value to check.
+ *
+ * @returns `true` if the value is an array; otherwise, `false`.
+ */
+const isArray = (value) => Array.isArray(value);
+/**
+ * Checks if a value is an empty array.
+ *
+ * @param value - The value to check.
+ *
+ * @returns `true` if the value is an empty array; otherwise, `false`.
+ */
+const isEmptyArray = (value) => isArray(value) && value.length === 0;
 /**
  * Removes all falsy values from an array.
  *
@@ -182,13 +200,26 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   filterParallel: () => (/* binding */ filterParallel),
 /* harmony export */   filterSequential: () => (/* binding */ filterSequential),
 /* harmony export */   findAsync: () => (/* binding */ findAsync),
+/* harmony export */   isPromise: () => (/* binding */ isPromise),
 /* harmony export */   reduceAsync: () => (/* binding */ reduceAsync),
 /* harmony export */   runParallel: () => (/* binding */ runParallel),
 /* 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 _function__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./function */ "./src/function.ts");
+
 
+/**
+ * Checks if a value is a Promise.
+ *
+ * @template T - The type of the value that the Promise resolves to.
+ *
+ * @param value - The value to check.
+ *
+ * @returns `true` if the value is a Promise; otherwise, `false`.
+ */
+const isPromise = (value) => (0,_function__WEBPACK_IMPORTED_MODULE_1__.isFunction)(value?.then);
 /**
  * Asynchronously iterates over an array and executes an async function on each item sequentially,
  * collecting the results.
@@ -567,8 +598,21 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   blobToFile: () => (/* binding */ blobToFile),
 /* harmony export */   fileListToFiles: () => (/* binding */ fileListToFiles),
-/* harmony export */   parseFileName: () => (/* binding */ parseFileName)
+/* harmony export */   isFile: () => (/* binding */ isFile),
+/* harmony export */   parseFileName: () => (/* binding */ parseFileName),
+/* harmony export */   readFilesFromDataTransfer: () => (/* binding */ readFilesFromDataTransfer),
+/* harmony export */   traverseFileSystemDirectory: () => (/* binding */ traverseFileSystemDirectory)
 /* harmony export */ });
+/* harmony import */ var _async__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./async */ "./src/async.ts");
+
+/**
+ * Checks if a value is a `File` object.
+ *
+ * @param value - The value to check.
+ *
+ * @returns `true` if the value is a `File` object; otherwise, `false`.
+ */
+const isFile = (value) => value instanceof File;
 /**
  * Splits a file name into its base name and extension.
  *
@@ -631,6 +675,125 @@ const fileListToFiles = (fileList) => {
 const blobToFile = (blob, fileName) => new File([blob], fileName, {
     type: blob.type,
 });
+/**
+ * Reads all entries from a file system directory asynchronously.
+ *
+ * @param directoryEntry - The directory entry to read.
+ *
+ * @returns A promise that resolves to all `FileSystemEntry` items in the directory.
+ */
+const readFileSystemDirectoryEntries = async (directoryEntry) => {
+    const directoryReader = directoryEntry.createReader();
+    const readAll = async () => new Promise((resolve, reject) => {
+        directoryReader.readEntries(async (entries) => {
+            if (!entries.length) {
+                resolve([]);
+                return;
+            }
+            try {
+                const restEntries = await readAll();
+                resolve([...entries, ...restEntries]);
+            }
+            catch (e) {
+                reject(e);
+            }
+        }, reject);
+    });
+    return readAll();
+};
+/**
+ * Recursively scans a directory using the File System API and collects all nested files.
+ *
+ * This function walks through all subdirectories, resolving each file into a `File` object.
+ * Directories themselves are not returned. To avoid unnecessary noise, certain system or
+ * OS-generated files can be excluded via the `skipFiles` option.
+ *
+ * A progress callback (`onProgress`) may be provided to receive updates each time a file
+ * is discovered. This is useful when working with large folders or deeply nested structures.
+ *
+ * @param directoryEntry - The starting directory entry to traverse.
+ * @param options - Optional settings that control traversal behavior.
+ * @param processed - Internal counter used to track the number of processed files
+ *   during recursive traversal. Not intended to be provided manually.
+ *
+ * @returns A promise resolving to a flat array of all collected `File` objects.
+ */
+const traverseFileSystemDirectory = async (directoryEntry, { skipFiles = [
+    '.DS_Store',
+    'Thumbs.db',
+    'desktop.ini',
+    'ehthumbs.db',
+    '.Spotlight-V100',
+    '.Trashes',
+    '.fseventsd',
+    '__MACOSX',
+], onProgress, } = {}, processed = 0) => {
+    const skipSet = new Set(skipFiles);
+    const entries = await readFileSystemDirectoryEntries(directoryEntry);
+    const filePromises = await (0,_async__WEBPACK_IMPORTED_MODULE_0__.runParallel)(entries, async (entry) => {
+        if (entry.isDirectory) {
+            return traverseFileSystemDirectory(entry, {
+                skipFiles,
+            }, processed);
+        }
+        else if (!skipSet.has(entry.name)) {
+            const file = await new Promise((resolve, reject) => {
+                entry.file(resolve, reject);
+            });
+            if (onProgress) {
+                processed++;
+                onProgress({
+                    processed,
+                    path: `${directoryEntry.fullPath}/${entry.name}`,
+                    currentFile: file,
+                });
+            }
+            return [file];
+        }
+        return [];
+    });
+    return filePromises.flat();
+};
+/**
+ * Reads files from a `DataTransfer` object, handling both dropped files
+ * and directories (via the non-standard `webkitGetAsEntry` API).
+ *
+ * @param dataTransfer - The DataTransfer object from a drop or paste event.
+ *
+ * @returns A promise resolving to a flat array of all extracted File objects.
+ */
+const readFilesFromDataTransfer = async (dataTransfer) => {
+    const items = dataTransfer?.items;
+    if (!items) {
+        return [];
+    }
+    const tasks = [];
+    for (let itemIndex = 0; itemIndex < items.length; itemIndex++) {
+        const item = items[itemIndex];
+        // Prefer using webkitGetAsEntry when available (directory support)
+        // https://developer.mozilla.org/en-US/docs/Web/API/DataTransferItem/webkitGetAsEntry#browser_compatibility
+        if ('webkitGetAsEntry' in item) {
+            // ?.() -> avoids throwing on Safari weirdness
+            const entry = item.webkitGetAsEntry?.();
+            if (entry?.isDirectory) {
+                tasks.push(traverseFileSystemDirectory(entry));
+                continue;
+            }
+            if (entry?.isFile) {
+                tasks.push(new Promise((resolve, reject) => {
+                    entry.file(file => resolve([file]), reject);
+                }));
+                continue;
+            }
+        }
+        // Fallback to standard API
+        const file = item.getAsFile();
+        if (file) {
+            tasks.push(Promise.resolve([file]));
+        }
+    }
+    return (await Promise.all(tasks)).flat();
+};
 
 
 /***/ }),
@@ -645,12 +808,21 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   delay: () => (/* binding */ delay),
 /* harmony export */   invokeIfFunction: () => (/* binding */ invokeIfFunction),
+/* harmony export */   isFunction: () => (/* binding */ isFunction),
 /* harmony export */   noop: () => (/* binding */ noop),
 /* harmony export */   not: () => (/* binding */ not),
 /* harmony export */   retry: () => (/* binding */ retry),
 /* harmony export */   timeout: () => (/* binding */ timeout)
 /* harmony export */ });
 const noop = () => { };
+/**
+ * Checks if a value is a function.
+ *
+ * @param value - The value to check.
+ *
+ * @returns `true` if the value is a function; otherwise, `false`.
+ */
+const isFunction = (value) => typeof value === 'function';
 /**
  * Creates a function that negates the result of the given predicate function.
  *
@@ -818,25 +990,19 @@ const retry = (task, { maxAttempts = 3, delayMs = 300, backoff = true, onRetry }
 __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),
 /* harmony export */   isDefined: () => (/* binding */ isDefined),
-/* harmony export */   isEmptyArray: () => (/* binding */ isEmptyArray),
 /* harmony export */   isEmptyObject: () => (/* binding */ isEmptyObject),
 /* harmony export */   isFiniteNumber: () => (/* binding */ isFiniteNumber),
-/* harmony export */   isFunction: () => (/* binding */ isFunction),
 /* harmony export */   isInteger: () => (/* binding */ isInteger),
 /* harmony export */   isMap: () => (/* binding */ isMap),
 /* harmony export */   isNil: () => (/* binding */ isNil),
-/* harmony export */   isNilOrEmptyString: () => (/* binding */ isNilOrEmptyString),
 /* harmony export */   isNull: () => (/* binding */ isNull),
 /* harmony export */   isNumber: () => (/* binding */ isNumber),
 /* harmony export */   isObject: () => (/* binding */ isObject),
-/* harmony export */   isPromise: () => (/* binding */ isPromise),
 /* harmony export */   isRegExp: () => (/* binding */ isRegExp),
 /* harmony export */   isSet: () => (/* binding */ isSet),
-/* harmony export */   isString: () => (/* binding */ isString),
 /* harmony export */   isSymbol: () => (/* binding */ isSymbol),
 /* harmony export */   isUndefined: () => (/* binding */ isUndefined),
 /* harmony export */   isValidDate: () => (/* binding */ isValidDate)
@@ -862,19 +1028,6 @@ const isNull = (value) => value === null;
  * @returns `true` if the value is `null` or `undefined`, otherwise `false`.
  */
 const isNil = (value) => value === undefined || value === null;
-/**
- * Checks whether the provided value is considered "empty".
- *
- * A value is considered empty if it is:
- * - `null`
- * - `undefined`
- * - `''`
- *
- * @param value - The value to check.
- *
- * @returns `true` if the value is empty; otherwise, `false`.
- */
-const isNilOrEmptyString = (value) => value === '' || isNil(value);
 /**
  * Checks if a value is neither `null` nor `undefined`.
  *
@@ -883,14 +1036,6 @@ const isNilOrEmptyString = (value) => value === '' || isNil(value);
  * @returns `true` if the value is defined (not `null` or `undefined`); otherwise, `false`.
  */
 const isDefined = (value) => value !== null && value !== undefined;
-/**
- * Checks if a value is a string.
- *
- * @param value - The value to check.
- *
- * @returns `true` if the value is a string; otherwise, `false`.
- */
-const isString = (value) => typeof value === 'string';
 /**
  * Checks if a value is a number.
  *
@@ -923,40 +1068,6 @@ const isObject = (value) => typeof value === 'object';
  * @returns `true` if the value is an empty object; otherwise, `false`.
  */
 const isEmptyObject = (value) => isObject(value) && !isNull(value) && Object.keys(value).length === 0;
-/**
- * Checks if a value is an array.
- *
- * @param value - The value to check.
- *
- * @returns `true` if the value is an array; otherwise, `false`.
- */
-const isArray = (value) => Array.isArray(value);
-/**
- * Checks if a value is an empty array.
- *
- * @param value - The value to check.
- *
- * @returns `true` if the value is an empty array; otherwise, `false`.
- */
-const isEmptyArray = (value) => isArray(value) && value.length === 0;
-/**
- * Checks if a value is a function.
- *
- * @param value - The value to check.
- *
- * @returns `true` if the value is a function; otherwise, `false`.
- */
-const isFunction = (value) => typeof value === 'function';
-/**
- * Checks if a value is a Promise.
- *
- * @template T - The type of the value that the Promise resolves to.
- *
- * @param value - The value to check.
- *
- * @returns `true` if the value is a Promise; otherwise, `false`.
- */
-const isPromise = (value) => isFunction(value?.then);
 /**
  * Checks if a value is a Date object.
  *
@@ -1095,9 +1206,34 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   camelToDashCase: () => (/* binding */ camelToDashCase),
 /* harmony export */   camelToWords: () => (/* binding */ camelToWords),
 /* harmony export */   hashString: () => (/* binding */ hashString),
+/* harmony export */   isNilOrEmptyString: () => (/* binding */ isNilOrEmptyString),
+/* harmony export */   isString: () => (/* binding */ isString),
 /* harmony export */   splitStringIntoWords: () => (/* binding */ splitStringIntoWords),
 /* harmony export */   toKebabCase: () => (/* binding */ toKebabCase)
 /* harmony export */ });
+/* harmony import */ var _guards__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./guards */ "./src/guards.ts");
+
+/**
+ * Checks if a value is a string.
+ *
+ * @param value - The value to check.
+ *
+ * @returns `true` if the value is a string; otherwise, `false`.
+ */
+const isString = (value) => typeof value === 'string';
+/**
+ * Checks whether the provided value is considered "empty".
+ *
+ * A value is considered empty if it is:
+ * - `null`
+ * - `undefined`
+ * - `''`
+ *
+ * @param value - The value to check.
+ *
+ * @returns `true` if the value is empty; otherwise, `false`.
+ */
+const isNilOrEmptyString = (value) => value === '' || (0,_guards__WEBPACK_IMPORTED_MODULE_0__.isNil)(value);
 /**
  * Converts a string to kebab-case format.
  *
@@ -1297,27 +1433,28 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   intersection: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_2__.intersection),
 /* harmony export */   invokeIfFunction: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_3__.invokeIfFunction),
 /* harmony export */   isAnchorHtmlElement: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.isAnchorHtmlElement),
-/* harmony export */   isArray: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isArray),
+/* harmony export */   isArray: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_2__.isArray),
 /* harmony export */   isBool: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isBool),
 /* harmony export */   isContentEditableHtmlElement: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.isContentEditableHtmlElement),
 /* harmony export */   isDate: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isDate),
 /* harmony export */   isDefined: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isDefined),
-/* harmony export */   isEmptyArray: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isEmptyArray),
+/* harmony export */   isEmptyArray: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_2__.isEmptyArray),
 /* harmony export */   isEmptyObject: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isEmptyObject),
+/* harmony export */   isFile: () => (/* reexport safe */ _file__WEBPACK_IMPORTED_MODULE_7__.isFile),
 /* harmony export */   isFiniteNumber: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isFiniteNumber),
-/* harmony export */   isFunction: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isFunction),
+/* harmony export */   isFunction: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_3__.isFunction),
 /* harmony export */   isHtmlElementFocusable: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.isHtmlElementFocusable),
 /* harmony export */   isInteger: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isInteger),
 /* harmony export */   isMap: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isMap),
 /* harmony export */   isNil: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isNil),
-/* harmony export */   isNilOrEmptyString: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isNilOrEmptyString),
+/* harmony export */   isNilOrEmptyString: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_1__.isNilOrEmptyString),
 /* harmony export */   isNull: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isNull),
 /* harmony export */   isNumber: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isNumber),
 /* harmony export */   isObject: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isObject),
-/* harmony export */   isPromise: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isPromise),
+/* harmony export */   isPromise: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_0__.isPromise),
 /* harmony export */   isRegExp: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isRegExp),
 /* harmony export */   isSet: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isSet),
-/* harmony export */   isString: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isString),
+/* harmony export */   isString: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_1__.isString),
 /* harmony export */   isSymbol: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isSymbol),
 /* harmony export */   isUndefined: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isUndefined),
 /* harmony export */   isValidDate: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isValidDate),
@@ -1326,6 +1463,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   parse2DMatrix: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.parse2DMatrix),
 /* harmony export */   parseFileName: () => (/* reexport safe */ _file__WEBPACK_IMPORTED_MODULE_7__.parseFileName),
 /* harmony export */   pipe: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_2__.pipe),
+/* harmony export */   readFilesFromDataTransfer: () => (/* reexport safe */ _file__WEBPACK_IMPORTED_MODULE_7__.readFilesFromDataTransfer),
 /* harmony export */   reduceAsync: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_0__.reduceAsync),
 /* harmony export */   retry: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_3__.retry),
 /* harmony export */   runParallel: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_0__.runParallel),
@@ -1334,6 +1472,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   splitStringIntoWords: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_1__.splitStringIntoWords),
 /* harmony export */   timeout: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_3__.timeout),
 /* harmony export */   toKebabCase: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_1__.toKebabCase),
+/* harmony export */   traverseFileSystemDirectory: () => (/* reexport safe */ _file__WEBPACK_IMPORTED_MODULE_7__.traverseFileSystemDirectory),
 /* harmony export */   unique: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_2__.unique)
 /* harmony export */ });
 /* harmony import */ var _async__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./async */ "./src/async.ts");