@react-hive/honey-utils 3.0.0 → 3.2.0

package/README.md

@@ -48,7 +48,32 @@ import * as HoneyUtils from '@react-hive/honey-utils';
 ### String Utilities
 
 ```ts
-import { toKebabCase, camelToDashCase, splitStringIntoWords, hashString } from '@react-hive/honey-utils';
+import {
+    isString,
+    isNilOrEmptyString,
+    toKebabCase,
+    camelToDashCase,
+    splitStringIntoWords,
+    hashString
+} from '@react-hive/honey-utils';
+
+/**
+ * Check if value is a string
+ */
+isString('hello');
+// ➜ true
+isString(123);
+// ➜ false
+
+/**
+ * Check if value is null, undefined, or empty string
+ */
+isNilOrEmptyString('');
+// ➜ true
+isNilOrEmptyString(null);
+// ➜ true
+isNilOrEmptyString('hello');
+// ➜ false
 
 /**
  * Convert string to kebab-case
@@ -79,6 +104,8 @@ const hash = hashString('background-color: red;');
 
 ```ts
 import {
+    isArray,
+    isEmptyArray,
     compact,
     unique,
     chunk,
@@ -88,6 +115,22 @@ import {
     compose,
 } from '@react-hive/honey-utils';
 
+/**
+ * Check if value is an array
+ */
+isArray([1, 2, 3]);
+// ➜ true
+isArray({});
+// ➜ false
+
+/**
+ * Check if value is an empty array
+ */
+isEmptyArray([]);
+// ➜ true
+isEmptyArray([1, 2, 3]);
+// ➜ false
+
 /**
  * Filter out falsy values from an array
  */
@@ -138,6 +181,7 @@ compose(increment, double)(3);
 
 ```ts
 import {
+    isPromise,
     runParallel,
     runSequential,
     reduceAsync,
@@ -147,6 +191,14 @@ import {
     findAsync,
 } from '@react-hive/honey-utils';
 
+/**
+ * Check if value is a Promise
+ */
+isPromise(Promise.resolve());
+// ➜ true
+isPromise({});
+// ➜ false
+
 /**
  * Run async operations in parallel and collect results
  */
@@ -214,13 +266,27 @@ await findAsync([1, 3, 4, 5], async (n) => {
 ### Function Utilities
 
 ```ts
-import { noop, invokeIfFunction, delay, retry } from '@react-hive/honey-utils';
+import {
+    noop,
+    isFunction,
+    invokeIfFunction,
+    delay,
+    retry
+} from '@react-hive/honey-utils';
 
 /**
  * No-operation function. Does nothing
  */
 noop();
 
+/**
+ * Check if value is a function
+ */
+isFunction(() => {});
+// ➜ true
+isFunction({});
+// ➜ false
+
 /**
  * Invoke if function, otherwise return value
  */
@@ -265,35 +331,21 @@ fetchWithRetry()
 ### Type Guards
 
 ```ts
-import { 
-  isString, 
-  isNumber, 
-  isBool, 
-  isObject, 
-  isFunction, 
-  isPromise, 
-  isNil, 
-  isNilOrEmptyString,
-  isArray,
-  isEmptyArray,
-  isEmptyObject,
-  isNull,
-  isUndefined,
-  isDate,
-  isValidDate,
-  isRegExp,
-  isMap,
-  isSet
+import {
+    isNumber,
+    isBool,
+    isObject,
+    isNil,
+    isEmptyObject,
+    isNull,
+    isUndefined,
+    isDate,
+    isValidDate,
+    isRegExp,
+    isMap,
+    isSet
 } from '@react-hive/honey-utils';
 
-/**
- * Check if value is a string
- */
-isString('hello');
-// ➜ true
-isString(123);
-// ➜ false
-
 /**
  * Check if value is a number
  */
@@ -318,22 +370,6 @@ isObject({});
 isObject('object');
 // ➜ false
 
-/**
- * Check if value is a function
- */
-isFunction(() => {});
-// ➜ true
-isFunction({});
-// ➜ false
-
-/**
- * Check if value is a Promise
- */
-isPromise(Promise.resolve());
-// ➜ true
-isPromise({});
-// ➜ false
-
 /**
  * Check if value is null or undefined
  */
@@ -344,32 +380,6 @@ isNil(undefined);
 isNil('');
 // ➜ false
 
-/**
- * Check if value is null, undefined, or empty string
- */
-isNilOrEmptyString('');
-// ➜ true
-isNilOrEmptyString(null);
-// ➜ true
-isNilOrEmptyString('hello');
-// ➜ false
-
-/**
- * Check if value is an array
- */
-isArray([1, 2, 3]);
-// ➜ true
-isArray({});
-// ➜ false
-
-/**
- * Check if value is an empty array
- */
-isEmptyArray([]);
-// ➜ true
-isEmptyArray([1, 2, 3]);
-// ➜ false
-
 /**
  * Check if value is an empty object
  */
@@ -414,10 +424,10 @@ isSet(new Set());
 ### Math Utilities
 
 ```ts
-import { 
-  calculateEuclideanDistance, 
-  calculateMovingSpeed, 
-  calculatePercentage 
+import {
+    calculateEuclideanDistance,
+    calculateMovingSpeed,
+    calculatePercentage 
 } from '@react-hive/honey-utils';
 
 /**
@@ -536,6 +546,8 @@ function divide(a: number, b: number): number {
 
 ### String Utilities
 
+- `isString(value: unknown): value is string` - Checks if a value is a `string`.
+- `isNilOrEmptyString(value: unknown): value is null | undefined` - Checks if a value is `null`, `undefined`, or an empty string.
 - `toKebabCase(input: string): string` - Converts a string to kebab-case.
 - `camelToDashCase(input: string): string` - Converts camelCase to dash-case.
 - `splitStringIntoWords(input: string): string[]` - Splits a string into an array of words.
@@ -543,6 +555,8 @@ function divide(a: number, b: number): number {
 
 ### Array Utilities
 
+- `isArray(value: unknown): value is unknown[]` - Checks if a value is an array.
+- `isEmptyArray(value: unknown): value is []` - Checks if a value is an empty array.
 - `compact<T>(array: (T | Falsy)[]): T[]` – Returns a new array with all falsy values (false, null, undefined, 0, '', NaN) removed, preserving only truthy items of type `T`.
 - `unique<T>(array: T[]): T[]` - Returns a new array with all duplicate elements removed. Keeps only the first occurrence of each value.
 - `chunk<T>(array: T[], size: number): T[][]` - Splits an array into smaller arrays ("chunks") of the specified size.
@@ -553,6 +567,7 @@ function divide(a: number, b: number): number {
 
 ### Function Utilities
 
+- `isFunction(value: unknown): value is Function` - Checks if a value is a `function`.
 - `noop(): void` - A no-operation function.
 - `not<Args extends any[]>(fn: (...args: Args) => any): (...args: Args) => boolean` - Creates a new function that negates the result of the given predicate function. Useful for logical inversions, e.g., turning `isEven` into `isOdd`.
 - `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.
@@ -563,16 +578,10 @@ function divide(a: number, b: number): number {
 ### Type Guards
 
 - `assert(condition: any, message: string): asserts condition` - Asserts that a condition is truthy, throwing an error with the provided message if it's not.
-- `isString(value: unknown): value is string` - Checks if a value is a `string`.
 - `isNumber(value: unknown): value is number` - Checks if a value is a `number`.
 - `isBool(value: unknown): value is boolean` - Checks if a value is a `boolean`.
 - `isObject(value: unknown): value is object` - Checks if a value is an `object`.
-- `isFunction(value: unknown): value is Function` - Checks if a value is a `function`.
-- `isPromise<T = unknown>(value: unknown): value is Promise<T>` - Checks if a value is a `Promise`.
 - `isNil(value: unknown): value is null | undefined` - Checks if a value is `null` or `undefined`.
-- `isNilOrEmptyString(value: unknown): value is null | undefined` - Checks if a value is `null`, `undefined`, or an empty string.
-- `isArray(value: unknown): value is unknown[]` - Checks if a value is an array.
-- `isEmptyArray(value: unknown): value is []` - Checks if a value is an empty array.
 - `isEmptyObject(value: unknown): value is Record<string, never>` - Checks if a value is an empty object.
 - `isNull(value: unknown): value is null` - Checks if a value is `null`.
 - `isUndefined(value: unknown): value is undefined` - Checks if a value is `undefined`.
@@ -605,12 +614,16 @@ function divide(a: number, b: number): number {
 
 ### File Utilities
 
+- `isFile(value: unknown): value is File` - Checks if a value is a `File`.
 - `parseFileName(fileName: string): [baseName: string, extension: string]` - Splits a file name into its base name and extension using the last `.` as the separator. Handles edge cases such as hidden files (`.gitignore`), multi-dot names (`archive.tar.gz`), and names ending with a dot (`"file."`). The extension is returned in lowercase.
 - `fileListToFiles(fileList: FileList | null): File[]` - Converts a `FileList` object (such as the one returned from an `<input type="file">`) into a standard array of `File` objects. Returns an empty array when the input is `null`.
 - `blobToFile(blob: Blob, fileName: string): File` - Converts a Blob object into a File object with the specified name.
+- `traverseFileSystemDirectory(directoryEntry: FileSystemDirectoryEntry, options?: TraverseDirectoryOptions): Promise<File[]>` — Recursively scans a directory using the File System API and returns all nested files as `File` objects. Supports skipping system files and reporting progress through an optional `onProgress` callback.
+- `readFilesFromDataTransfer(dataTransfer: DataTransfer | null): Promise<File[]>` — Reads files from a `DataTransfer` object (such as drag-and-drop or paste events). Supports both regular dropped files and entire directories via the non-standard `webkitGetAsEntry` API. Directories are traversed recursively, returning a flat array of all extracted `File` objects.
 
 ### Asynchronous Utilities
 
+- `isPromise<T = unknown>(value: unknown): value is Promise<T>` - Checks if a value is a `Promise`.
 - `runSequential<Item, Result>(array: Item[], fn: (item, index, array) => Promise<Result>): Promise<Result[]>` - Runs asynchronous operations on each array item *sequentially* and returns the results in the original order.
 - `runParallel<Item, Result>(array: Item[], fn: (item, index, array) => Promise<Result>): Promise<Result[]>` - Executes an asynchronous function for each array item *in parallel* and returns a promise of all results.
 - `reduceAsync<Item, Accumulator>(array: Item[], fn, initialValue): Promise<Accumulator>` - Asynchronously reduces an array to a single accumulated value. Each step waits for the previous promise to resolve.

package/dist/README.md

@@ -48,7 +48,32 @@ import * as HoneyUtils from '@react-hive/honey-utils';
 ### String Utilities
 
 ```ts
-import { toKebabCase, camelToDashCase, splitStringIntoWords, hashString } from '@react-hive/honey-utils';
+import {
+    isString,
+    isNilOrEmptyString,
+    toKebabCase,
+    camelToDashCase,
+    splitStringIntoWords,
+    hashString
+} from '@react-hive/honey-utils';
+
+/**
+ * Check if value is a string
+ */
+isString('hello');
+// ➜ true
+isString(123);
+// ➜ false
+
+/**
+ * Check if value is null, undefined, or empty string
+ */
+isNilOrEmptyString('');
+// ➜ true
+isNilOrEmptyString(null);
+// ➜ true
+isNilOrEmptyString('hello');
+// ➜ false
 
 /**
  * Convert string to kebab-case
@@ -79,6 +104,8 @@ const hash = hashString('background-color: red;');
 
 ```ts
 import {
+    isArray,
+    isEmptyArray,
     compact,
     unique,
     chunk,
@@ -88,6 +115,22 @@ import {
     compose,
 } from '@react-hive/honey-utils';
 
+/**
+ * Check if value is an array
+ */
+isArray([1, 2, 3]);
+// ➜ true
+isArray({});
+// ➜ false
+
+/**
+ * Check if value is an empty array
+ */
+isEmptyArray([]);
+// ➜ true
+isEmptyArray([1, 2, 3]);
+// ➜ false
+
 /**
  * Filter out falsy values from an array
  */
@@ -138,6 +181,7 @@ compose(increment, double)(3);
 
 ```ts
 import {
+    isPromise,
     runParallel,
     runSequential,
     reduceAsync,
@@ -147,6 +191,14 @@ import {
     findAsync,
 } from '@react-hive/honey-utils';
 
+/**
+ * Check if value is a Promise
+ */
+isPromise(Promise.resolve());
+// ➜ true
+isPromise({});
+// ➜ false
+
 /**
  * Run async operations in parallel and collect results
  */
@@ -214,13 +266,27 @@ await findAsync([1, 3, 4, 5], async (n) => {
 ### Function Utilities
 
 ```ts
-import { noop, invokeIfFunction, delay, retry } from '@react-hive/honey-utils';
+import {
+    noop,
+    isFunction,
+    invokeIfFunction,
+    delay,
+    retry
+} from '@react-hive/honey-utils';
 
 /**
  * No-operation function. Does nothing
  */
 noop();
 
+/**
+ * Check if value is a function
+ */
+isFunction(() => {});
+// ➜ true
+isFunction({});
+// ➜ false
+
 /**
  * Invoke if function, otherwise return value
  */
@@ -265,35 +331,21 @@ fetchWithRetry()
 ### Type Guards
 
 ```ts
-import { 
-  isString, 
-  isNumber, 
-  isBool, 
-  isObject, 
-  isFunction, 
-  isPromise, 
-  isNil, 
-  isNilOrEmptyString,
-  isArray,
-  isEmptyArray,
-  isEmptyObject,
-  isNull,
-  isUndefined,
-  isDate,
-  isValidDate,
-  isRegExp,
-  isMap,
-  isSet
+import {
+    isNumber,
+    isBool,
+    isObject,
+    isNil,
+    isEmptyObject,
+    isNull,
+    isUndefined,
+    isDate,
+    isValidDate,
+    isRegExp,
+    isMap,
+    isSet
 } from '@react-hive/honey-utils';
 
-/**
- * Check if value is a string
- */
-isString('hello');
-// ➜ true
-isString(123);
-// ➜ false
-
 /**
  * Check if value is a number
  */
@@ -318,22 +370,6 @@ isObject({});
 isObject('object');
 // ➜ false
 
-/**
- * Check if value is a function
- */
-isFunction(() => {});
-// ➜ true
-isFunction({});
-// ➜ false
-
-/**
- * Check if value is a Promise
- */
-isPromise(Promise.resolve());
-// ➜ true
-isPromise({});
-// ➜ false
-
 /**
  * Check if value is null or undefined
  */
@@ -344,32 +380,6 @@ isNil(undefined);
 isNil('');
 // ➜ false
 
-/**
- * Check if value is null, undefined, or empty string
- */
-isNilOrEmptyString('');
-// ➜ true
-isNilOrEmptyString(null);
-// ➜ true
-isNilOrEmptyString('hello');
-// ➜ false
-
-/**
- * Check if value is an array
- */
-isArray([1, 2, 3]);
-// ➜ true
-isArray({});
-// ➜ false
-
-/**
- * Check if value is an empty array
- */
-isEmptyArray([]);
-// ➜ true
-isEmptyArray([1, 2, 3]);
-// ➜ false
-
 /**
  * Check if value is an empty object
  */
@@ -414,10 +424,10 @@ isSet(new Set());
 ### Math Utilities
 
 ```ts
-import { 
-  calculateEuclideanDistance, 
-  calculateMovingSpeed, 
-  calculatePercentage 
+import {
+    calculateEuclideanDistance,
+    calculateMovingSpeed,
+    calculatePercentage 
 } from '@react-hive/honey-utils';
 
 /**
@@ -536,6 +546,8 @@ function divide(a: number, b: number): number {
 
 ### String Utilities
 
+- `isString(value: unknown): value is string` - Checks if a value is a `string`.
+- `isNilOrEmptyString(value: unknown): value is null | undefined` - Checks if a value is `null`, `undefined`, or an empty string.
 - `toKebabCase(input: string): string` - Converts a string to kebab-case.
 - `camelToDashCase(input: string): string` - Converts camelCase to dash-case.
 - `splitStringIntoWords(input: string): string[]` - Splits a string into an array of words.
@@ -543,6 +555,8 @@ function divide(a: number, b: number): number {
 
 ### Array Utilities
 
+- `isArray(value: unknown): value is unknown[]` - Checks if a value is an array.
+- `isEmptyArray(value: unknown): value is []` - Checks if a value is an empty array.
 - `compact<T>(array: (T | Falsy)[]): T[]` – Returns a new array with all falsy values (false, null, undefined, 0, '', NaN) removed, preserving only truthy items of type `T`.
 - `unique<T>(array: T[]): T[]` - Returns a new array with all duplicate elements removed. Keeps only the first occurrence of each value.
 - `chunk<T>(array: T[], size: number): T[][]` - Splits an array into smaller arrays ("chunks") of the specified size.
@@ -553,6 +567,7 @@ function divide(a: number, b: number): number {
 
 ### Function Utilities
 
+- `isFunction(value: unknown): value is Function` - Checks if a value is a `function`.
 - `noop(): void` - A no-operation function.
 - `not<Args extends any[]>(fn: (...args: Args) => any): (...args: Args) => boolean` - Creates a new function that negates the result of the given predicate function. Useful for logical inversions, e.g., turning `isEven` into `isOdd`.
 - `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.
@@ -563,16 +578,10 @@ function divide(a: number, b: number): number {
 ### Type Guards
 
 - `assert(condition: any, message: string): asserts condition` - Asserts that a condition is truthy, throwing an error with the provided message if it's not.
-- `isString(value: unknown): value is string` - Checks if a value is a `string`.
 - `isNumber(value: unknown): value is number` - Checks if a value is a `number`.
 - `isBool(value: unknown): value is boolean` - Checks if a value is a `boolean`.
 - `isObject(value: unknown): value is object` - Checks if a value is an `object`.
-- `isFunction(value: unknown): value is Function` - Checks if a value is a `function`.
-- `isPromise<T = unknown>(value: unknown): value is Promise<T>` - Checks if a value is a `Promise`.
 - `isNil(value: unknown): value is null | undefined` - Checks if a value is `null` or `undefined`.
-- `isNilOrEmptyString(value: unknown): value is null | undefined` - Checks if a value is `null`, `undefined`, or an empty string.
-- `isArray(value: unknown): value is unknown[]` - Checks if a value is an array.
-- `isEmptyArray(value: unknown): value is []` - Checks if a value is an empty array.
 - `isEmptyObject(value: unknown): value is Record<string, never>` - Checks if a value is an empty object.
 - `isNull(value: unknown): value is null` - Checks if a value is `null`.
 - `isUndefined(value: unknown): value is undefined` - Checks if a value is `undefined`.
@@ -605,12 +614,16 @@ function divide(a: number, b: number): number {
 
 ### File Utilities
 
+- `isFile(value: unknown): value is File` - Checks if a value is a `File`.
 - `parseFileName(fileName: string): [baseName: string, extension: string]` - Splits a file name into its base name and extension using the last `.` as the separator. Handles edge cases such as hidden files (`.gitignore`), multi-dot names (`archive.tar.gz`), and names ending with a dot (`"file."`). The extension is returned in lowercase.
 - `fileListToFiles(fileList: FileList | null): File[]` - Converts a `FileList` object (such as the one returned from an `<input type="file">`) into a standard array of `File` objects. Returns an empty array when the input is `null`.
 - `blobToFile(blob: Blob, fileName: string): File` - Converts a Blob object into a File object with the specified name.
+- `traverseFileSystemDirectory(directoryEntry: FileSystemDirectoryEntry, options?: TraverseDirectoryOptions): Promise<File[]>` — Recursively scans a directory using the File System API and returns all nested files as `File` objects. Supports skipping system files and reporting progress through an optional `onProgress` callback.
+- `readFilesFromDataTransfer(dataTransfer: DataTransfer | null): Promise<File[]>` — Reads files from a `DataTransfer` object (such as drag-and-drop or paste events). Supports both regular dropped files and entire directories via the non-standard `webkitGetAsEntry` API. Directories are traversed recursively, returning a flat array of all extracted `File` objects.
 
 ### Asynchronous Utilities
 
+- `isPromise<T = unknown>(value: unknown): value is Promise<T>` - Checks if a value is a `Promise`.
 - `runSequential<Item, Result>(array: Item[], fn: (item, index, array) => Promise<Result>): Promise<Result[]>` - Runs asynchronous operations on each array item *sequentially* and returns the results in the original order.
 - `runParallel<Item, Result>(array: Item[], fn: (item, index, array) => Promise<Result>): Promise<Result[]>` - Executes an asynchronous function for each array item *in parallel* and returns a promise of all results.
 - `reduceAsync<Item, Accumulator>(array: Item[], fn, initialValue): Promise<Accumulator>` - Asynchronously reduces an array to a single accumulated value. Each step waits for the previous promise to resolve.

package/dist/array.d.ts

@@ -1,3 +1,19 @@
+/**
+ * Checks if a value is an array.
+ *
+ * @param value - The value to check.
+ *
+ * @returns `true` if the value is an array; otherwise, `false`.
+ */
+export declare const isArray: (value: unknown) => value is unknown[];
+/**
+ * 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`.
+ */
+export declare const isEmptyArray: (value: unknown) => value is [];
 /**
  * Represents all falsy values.
  */

package/dist/async.d.ts

@@ -1,3 +1,13 @@
+/**
+ * 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`.
+ */
+export declare const isPromise: <T = unknown>(value: unknown) => value is Promise<T>;
 /**
  * Asynchronously iterates over an array and executes an async function on each item sequentially,
  * collecting the results.

package/dist/file.d.ts

@@ -1,3 +1,11 @@
+/**
+ * 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`.
+ */
+export declare const isFile: (value: unknown) => value is File;
 /**
  * Splits a file name into its base name and extension.
  *
@@ -42,3 +50,59 @@ export declare const fileListToFiles: (fileList: FileList | null) => File[];
  * ```
  */
 export declare const blobToFile: (blob: Blob, fileName: string) => File;
+/**
+ * A callback function invoked whenever a file is discovered during directory traversal.
+ *
+ * @param progress - An object containing details about the current traversal state.
+ * @param progress.processed - The total number of files processed so far.
+ * @param progress.currentFile - The `File` object for the file just discovered (if available).
+ * @param progress.path - The full path of the file relative to the traversed directory (if available).
+ */
+type TraverseDirectoryOnProgressHandler = (progress: {
+    processed: number;
+    currentFile?: File;
+    path?: string;
+}) => void;
+interface TraverseDirectoryOptions {
+    /**
+     * A list of file names that should be ignored during traversal.
+     * Any file whose name matches an entry will be skipped entirely.
+     *
+     * Common values include OS-generated metadata files such as:
+     * `.DS_Store`, `Thumbs.db`, `desktop.ini`, `.Spotlight-V100`, etc.
+     */
+    skipFiles?: string[];
+    /**
+     * Optional callback invoked each time a file is discovered.
+     * Useful for progress tracking when traversing large or deeply nested directories.
+     */
+    onProgress?: TraverseDirectoryOnProgressHandler;
+}
+/**
+ * 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.
+ */
+export declare const traverseFileSystemDirectory: (directoryEntry: FileSystemDirectoryEntry, { skipFiles, onProgress, }?: TraverseDirectoryOptions, processed?: number) => Promise<File[]>;
+/**
+ * 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.
+ */
+export declare const readFilesFromDataTransfer: (dataTransfer: DataTransfer | null) => Promise<File[]>;
+export {};