@react-hive/honey-utils 3.13.1 → 3.15.0

package/README.md

@@ -553,7 +553,7 @@ function divide(a: number, b: number): number {
 - `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.
-- `hashString(input: string): string` - Generates a short hash from a string.
+- `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.
 
 ### Object Utilities
 
@@ -583,9 +583,6 @@ function divide(a: number, b: number): number {
 - `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.
-- `delay(delayMs: number): Promise<void>` - Creates a promise that resolves after the specified delay in milliseconds.
-- `timeout<T>(promise: Promise<T>, timeoutMs: number, message?: string): Promise<T>` - Wraps a promise with a timeout. If the promise does not settle within the given duration, it rejects with a timeout error.
-- `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.
 - `once<T extends (...args: any[]) => any>(fn: T): T` - Wraps a function so it can only be executed once. The result of the first invocation is cached and returned for all subsequent calls. Preserves both the original function’s parameter types and `this` binding.
 
 ### Type Guards
@@ -620,6 +617,7 @@ function divide(a: number, b: number): number {
 - `calculateEuclideanDistance(startX: number, startY: number, endX: number, endY: number): number` - Calculates the Euclidean distance between two points.
 - `calculateMovingSpeed(distance: number, elapsedTime: number): number` - Calculates moving speed.
 - `calculatePercentage(value: number, percentage: number): number` - Calculates the specified percentage of a value.
+- `hashString(input: string): string` - Generates a short hash from a string.
 
 ### ENV
 
@@ -634,6 +632,9 @@ function divide(a: number, b: number): number {
 
 ---
 
+- `resolveBoundedDelta(options: ResolveBoundedDeltaOptions): Nullable<number>` – Resolves the next numeric value by consuming a delta within fixed bounds. Prevents overshoot, partially consumes deltas at boundaries, and returns `null` when movement in the given direction is no longer possible. Useful for drag constraints, sliders, synthetic scrolling, and inertia systems.
+- `applyInertiaStep(options: ApplyInertiaStepOptions): Nullable<{ value: number; velocity: number }>` – Applies a single inertia step on top of bounded delta resolution using velocity integration and exponential friction. Intended to be called from an animation loop (e.g. `requestAnimationFrame`) to implement momentum-based scrolling, sliders, or carousels. Returns updated value and velocity, or `null` when inertia has completed.
+
 #### Layout
 
 - `calculateCenterOffset(options: CalculateCenterOffsetOptions): number` - Calculates a clamped offset value that centers an element within a container along a single axis. Returns a negative value suitable for use in a CSS `translate` transform, or `0` when no overflow exists.
@@ -668,7 +669,6 @@ function divide(a: number, b: number): number {
 ---
 
 - `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.
@@ -687,6 +687,9 @@ function divide(a: number, b: number): number {
 - `someAsync<Item>(array: Item[], predicate): Promise<boolean>` - Returns `true` if **any** item in the array passes the async predicate.
 - `everyAsync<Item>(array: Item[], predicate): Promise<boolean>` - Returns `true` if **all** items in the array pass the async predicate.
 - `findAsync<Item>(array: Item[], predicate): Promise<Nullable<Item>>` - Returns the first array item that passes the async predicate, or `null` if no match is found.
+- `delay(delayMs: number): Promise<void>` - Creates a promise that resolves after the specified delay in milliseconds.
+- `timeout<T>(promise: Promise<T>, timeoutMs: number, message?: string): Promise<T>` - Wraps a promise with a timeout. If the promise does not settle within the given duration, it rejects with a timeout error.
+- `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.
 
 ### Intersection Utilities
 

package/dist/README.md

@@ -553,7 +553,7 @@ function divide(a: number, b: number): number {
 - `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.
-- `hashString(input: string): string` - Generates a short hash from a string.
+- `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.
 
 ### Object Utilities
 
@@ -583,9 +583,6 @@ function divide(a: number, b: number): number {
 - `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.
-- `delay(delayMs: number): Promise<void>` - Creates a promise that resolves after the specified delay in milliseconds.
-- `timeout<T>(promise: Promise<T>, timeoutMs: number, message?: string): Promise<T>` - Wraps a promise with a timeout. If the promise does not settle within the given duration, it rejects with a timeout error.
-- `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.
 - `once<T extends (...args: any[]) => any>(fn: T): T` - Wraps a function so it can only be executed once. The result of the first invocation is cached and returned for all subsequent calls. Preserves both the original function’s parameter types and `this` binding.
 
 ### Type Guards
@@ -620,6 +617,7 @@ function divide(a: number, b: number): number {
 - `calculateEuclideanDistance(startX: number, startY: number, endX: number, endY: number): number` - Calculates the Euclidean distance between two points.
 - `calculateMovingSpeed(distance: number, elapsedTime: number): number` - Calculates moving speed.
 - `calculatePercentage(value: number, percentage: number): number` - Calculates the specified percentage of a value.
+- `hashString(input: string): string` - Generates a short hash from a string.
 
 ### ENV
 
@@ -634,6 +632,9 @@ function divide(a: number, b: number): number {
 
 ---
 
+- `resolveBoundedDelta(options: ResolveBoundedDeltaOptions): Nullable<number>` – Resolves the next numeric value by consuming a delta within fixed bounds. Prevents overshoot, partially consumes deltas at boundaries, and returns `null` when movement in the given direction is no longer possible. Useful for drag constraints, sliders, synthetic scrolling, and inertia systems.
+- `applyInertiaStep(options: ApplyInertiaStepOptions): Nullable<{ value: number; velocity: number }>` – Applies a single inertia step on top of bounded delta resolution using velocity integration and exponential friction. Intended to be called from an animation loop (e.g. `requestAnimationFrame`) to implement momentum-based scrolling, sliders, or carousels. Returns updated value and velocity, or `null` when inertia has completed.
+
 #### Layout
 
 - `calculateCenterOffset(options: CalculateCenterOffsetOptions): number` - Calculates a clamped offset value that centers an element within a container along a single axis. Returns a negative value suitable for use in a CSS `translate` transform, or `0` when no overflow exists.
@@ -668,7 +669,6 @@ function divide(a: number, b: number): number {
 ---
 
 - `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.
@@ -687,6 +687,9 @@ function divide(a: number, b: number): number {
 - `someAsync<Item>(array: Item[], predicate): Promise<boolean>` - Returns `true` if **any** item in the array passes the async predicate.
 - `everyAsync<Item>(array: Item[], predicate): Promise<boolean>` - Returns `true` if **all** items in the array pass the async predicate.
 - `findAsync<Item>(array: Item[], predicate): Promise<Nullable<Item>>` - Returns the first array item that passes the async predicate, or `null` if no match is found.
+- `delay(delayMs: number): Promise<void>` - Creates a promise that resolves after the specified delay in milliseconds.
+- `timeout<T>(promise: Promise<T>, timeoutMs: number, message?: string): Promise<T>` - Wraps a promise with a timeout. If the promise does not settle within the given duration, it rejects with a timeout error.
+- `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.
 
 ### Intersection Utilities
 

package/dist/a11y/focus/is-html-element-focusable.d.ts

@@ -1,4 +1,4 @@
-import type { Nullable } from '../../types';
+import type { Nullable } from '~/types';
 export declare const FOCUSABLE_HTML_TAGS: string[];
 /**
  * Determines whether an HTMLElement is focusable under standard browser rules.

package/dist/a11y/focus/move-focus-within-container.d.ts

@@ -1,4 +1,4 @@
-import type { Nullable } from '../../types';
+import type { Nullable } from '~/types';
 export type FocusMoveDirection = 'next' | 'previous';
 export interface MoveFocusWithinContainerOptions {
     /**

package/dist/{async.d.ts → async/async.d.ts}

@@ -1,4 +1,4 @@
-import type { Nullable } from './types';
+import type { Nullable } from '~/types';
 /**
  * Checks if a value is a Promise.
  *

package/dist/async/delay.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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
+ * const fetchWithTimeout = async () => {
+ *   const timeoutPromise = delay(5000).then(() => {
+ *     throw new Error('Request timed out');
+ *   });
+ *
+ *   return Promise.race([fetchData(), timeoutPromise]);
+ * }
+ * ```
+ */
+export declare const delay: (delayMs: number) => Promise<void>;

package/dist/async/index.d.ts

@@ -0,0 +1,4 @@
+export * from './async';
+export * from './delay';
+export * from './timeout';
+export * from './retry';

package/dist/async/retry.d.ts

@@ -0,0 +1,72 @@
+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/async/timeout.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Wraps a promise with a timeout. If the promise does not settle within the specified time,
+ * it will reject with a timeout error.
+ *
+ * @template T - The type of the promise result.
+ *
+ * @param promise - The promise to wrap.
+ * @param timeoutMs - Timeout duration in milliseconds.
+ * @param errorMessage - Optional custom error message.
+ *
+ * @returns A promise that resolves or rejects with the original promise,
+ *          or rejects with a timeout error if the duration is exceeded.
+ *
+ * @example
+ * ```ts
+ * // Rejects if fetch takes longer than 3 seconds
+ * const response = await timeout(fetch('/api/data'), 3000);
+ *
+ * // With custom message
+ * await timeout(fetchData(), 2000, 'Too long');
+ * ```
+ */
+export declare const timeout: <T>(promise: Promise<T>, timeoutMs: number, errorMessage?: string) => Promise<T>;

package/dist/file.d.ts

@@ -1,4 +1,4 @@
-import type { Nullable } from './types';
+import type { Nullable } from '~/types';
 /**
  * Checks if a value is a `File` object.
  *
@@ -7,22 +7,6 @@ import type { Nullable } from './types';
  * @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.
- *
- * Special cases:
- * - Files without a dot return `[fileName, ""]`
- * - Hidden files like `.gitignore` return `[".gitignore", ""]`
- * - Names ending with a trailing dot (e.g., `"file."`) return `["file.", ""]`
- * - Multi-dot names (e.g., `"archive.tar.gz"`) split on the last dot
- *
- * @param fileName - The full file name to parse.
- *
- * @returns A tuple where:
- *  - index 0 is the base name
- *  - index 1 is the file extension (lowercased), or an empty string if none exists
- */
-export declare const parseFileName: (fileName: string) => string[];
 /**
  * Converts a `FileList` object to an array of `File` objects.
  *

package/dist/function/function.d.ts

@@ -0,0 +1,47 @@
+export declare const noop: () => void;
+/**
+ * Checks if a value is a function.
+ *
+ * @param value - The value to check.
+ *
+ * @returns `true` if the value is a function; otherwise, `false`.
+ */
+export declare const isFunction: (value: unknown) => value is Function;
+/**
+ * Creates a function that negates the result of the given predicate function.
+ *
+ * @template Args - Argument types of the predicate function.
+ *
+ * @param fn - A function that returns any value.
+ *
+ * @returns A new function that returns the negated result of the original function.
+ *
+ * @example
+ * ```ts
+ * const isEven = (n: number) => n % 2 === 0;
+ * const isOdd = not(isEven);
+ *
+ * console.log(isOdd(2)); // false
+ * console.log(isOdd(3)); // true
+ * ```
+ */
+export declare const not: <Args extends unknown[]>(fn: (...args: Args) => any) => ((...args: Args) => boolean);
+/**
+ * Wraps a function so that it can only be executed once.
+ * The wrapped function remembers (caches) the result of the first invocation
+ * and returns that same result for all subsequent calls, regardless of the arguments provided.
+ *
+ * Common use cases include:
+ * - initializing singletons
+ * - running setup logic only once
+ * - avoiding repeated expensive computations
+ *
+ * @template T - A function type whose return value should be cached.
+ *
+ * @param fn - The function to execute at most once.
+ *
+ * @returns A new function with the same signature as `fn`, but guaranteed to
+ *          execute `fn` only on the first call and return the cached result
+ *          thereafter.
+ */
+export declare const once: <T extends (...args: any[]) => any>(fn: T) => T;

package/dist/function/index.d.ts

@@ -0,0 +1,2 @@
+export * from './function';
+export * from './invoke-if-function';

package/dist/function/invoke-if-function.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Invokes the given input if it is a function, passing the provided arguments.
+ * Otherwise, returns the input as-is.
+ *
+ * @template Args - Tuple of argument types to pass to the function.
+ * @template Result - Return type of the function or the value.
+ *
+ * @param input - A function to invoke with `args`, or a direct value of type `Result`.
+ * @param args - Arguments to pass if `input` is a function.
+ *
+ * @returns The result of invoking the function, or the original value if it's not a function.
+ */
+export declare const invokeIfFunction: <Args extends unknown[], Result>(input: ((...args: Args) => Result) | Result, ...args: Args) => Result;

package/dist/geometry/apply-inertia-step.d.ts

@@ -0,0 +1,134 @@
+import type { Nullable } from '~/types';
+export interface InertiaOptions {
+    /**
+     * Current velocity of the motion, expressed in units per millisecond.
+     *
+     * The unit depends on the context in which inertia is applied:
+     * - `px/ms` for scrolling or dragging
+     * - arbitrary units for sliders or timelines
+     *
+     * The sign indicates direction (positive or negative).
+     */
+    velocity: number;
+    /**
+     * Time elapsed since the previous inertia step, in milliseconds.
+     *
+     * This value is typically derived from a high-resolution clock such as `performance.now()`
+     * and allows inertia behavior to remain frame-rate independent.
+     */
+    deltaTime: number;
+    /**
+     * Exponential friction coefficient controlling how quickly velocity decays over time.
+     *
+     * This value is applied per millisecond and produces smooth, natural-feeling
+     * deceleration when used with an exponential decay model.
+     *
+     * Smaller values result in a longer glide; larger values cause inertia
+     * to stop more quickly.
+     *
+     * Typical values:
+     * - `0.001` – very long, floaty motion
+     * - `0.002` – balanced, natural decay (default)
+     * - `0.005` – quick stop
+     *
+     * @default 0.002
+     */
+    friction?: number;
+    /**
+     * Minimum absolute velocity below which inertia is considered complete.
+     *
+     * When the absolute value of the current velocity drops below this threshold,
+     * no further movement is applied and inertia terminates.
+     *
+     * This prevents unnecessary micro-updates and jitter near rest.
+     *
+     * @default 0.01
+     */
+    minVelocity?: number;
+}
+interface ApplyInertiaStepOptions extends InertiaOptions {
+    /**
+     * Current value before applying the inertia step.
+     *
+     * This typically represents a translated position (e.g. scroll offset),
+     * but may be any bounded numeric value.
+     */
+    value: number;
+    /**
+     * Lower bound for the value (inclusive).
+     */
+    min: number;
+    /**
+     * Upper bound for the value (inclusive).
+     */
+    max: number;
+}
+/**
+ * Advances a value by one inertia step using velocity, friction, and hard bounds.
+ *
+ * This utility models **inertial motion** (momentum + decay) on top of
+ * {@link resolveBoundedDelta}, which acts as the authoritative constraint layer.
+ *
+ * The function:
+ * - Integrates velocity over the elapsed time to produce a movement delta
+ * - Resolves that delta against fixed bounds
+ * - Applies exponential friction to gradually reduce velocity
+ * - Stops immediately when a bound is hit or velocity falls below a threshold
+ *
+ * ⚠️ This function performs **one step only** and is intended to be called
+ * repeatedly from an animation loop (e.g. `requestAnimationFrame`).
+ *
+ * ### Common use cases
+ * - Synthetic scrolling with momentum
+ * - Carousels and sliders
+ * - Timelines and scrubbers
+ * - Drag-to-scroll interactions with inertia
+ *
+ * @param value - Current value before applying inertia (e.g. translate position).
+ * @param min - Minimum allowed value (inclusive).
+ * @param max - Maximum allowed value (inclusive).
+ * @param velocity - Current velocity in units per millisecond (e.g. px/ms).
+ * @param deltaTime - Time elapsed since the previous step, in milliseconds.
+ * @param friction - Exponential friction coefficient controlling decay rate.
+ * @param minVelocity - Minimum velocity below which inertia stops.
+ *
+ * @returns An object containing the updated value and velocity,
+ *          or `null` when inertia has completed or movement is no longer possible.
+ *
+ * @example
+ * ```ts
+ * let value = translateX;
+ * let velocity = releaseVelocity; // px/ms from drag end
+ * let lastTime = performance.now();
+ *
+ * const step = (time: number) => {
+ *   const deltaTime = time - lastTime;
+ *   lastTime = time;
+ *
+ *   const result = applyInertiaStep({
+ *     value,
+ *     velocity,
+ *     min: -maxOverflow,
+ *     max: 0,
+ *     deltaTime,
+ *   });
+ *
+ *   if (!result) {
+ *     return; // inertia finished
+ *   }
+ *
+ *   value = result.value;
+ *   velocity = result.velocity;
+ *
+ *   container.style.transform = `translateX(${value}px)`;
+ *   requestAnimationFrame(step);
+ * };
+ *
+ * requestAnimationFrame(step);
+ * ```
+ */
+export declare const applyInertiaStep: ({ value, min, max, velocity, deltaTime, friction, minVelocity, }: ApplyInertiaStepOptions) => Nullable<{
+    value: number;
+    velocity: number;
+}>;
+export {};

package/dist/geometry/index.d.ts

@@ -1 +1,3 @@
 export * from './layout';
+export * from './resolve-bounded-delta';
+export * from './apply-inertia-step';

package/dist/geometry/resolve-bounded-delta.d.ts

@@ -0,0 +1,79 @@
+import type { Nullable } from '~/types';
+interface ResolveBoundedDeltaOptions {
+    /**
+     * Incremental change to apply to the current value.
+     *
+     * The sign of this value determines the direction of movement:
+     * - Negative values move toward the minimum bound
+     * - Positive values move toward the maximum bound
+     */
+    delta: number;
+    /**
+     * Current numeric value before applying the delta.
+     */
+    value: number;
+    /**
+     * Minimum allowed value (inclusive).
+     *
+     * Movement beyond this boundary is prevented.
+     */
+    min: number;
+    /**
+     * Maximum allowed value (inclusive).
+     *
+     * Movement beyond this boundary is prevented.
+     */
+    max: number;
+}
+/**
+ * Resolves the next value by consuming a delta within fixed numeric bounds.
+ *
+ * This function applies **bounded delta consumption** rather than naive clamping:
+ *
+ * - The delta is applied in the given direction as long as movement is possible.
+ * - If the delta would overshoot a bound, it is partially consumed so the
+ *   resulting value lands exactly on the boundary.
+ * - If movement in the given direction is no longer possible, `null` is returned.
+ *
+ * This behavior mirrors how native scroll engines and drag constraints
+ * handle fast input without jitter or overshoot.
+ *
+ * ### Key characteristics
+ * - Direction-aware (positive and negative deltas behave independently)
+ * - Prevents overshoot while preserving remaining movement
+ * - Does **not** clamp unconditionally
+ * - Side-effect free and fully deterministic
+ *
+ * ### Common use cases
+ * - Synthetic scrolling
+ * - Drag constraints
+ * - Sliders and carousels
+ * - Timelines and scrubbers
+ * - Inertia and momentum systems
+ *
+ * @param delta - Incremental change to apply to the current value.
+ *               The sign determines the movement direction.
+ * @param value - Current numeric value before applying the delta.
+ * @param min - Minimum allowed value (inclusive).
+ * @param max - Maximum allowed value (inclusive).
+ *
+ * @returns The next resolved value after applying the delta,
+ *          or `null` if movement in the given direction is not possible.
+ *
+ * @example
+ * ```ts
+ * // Simple bounded movement
+ * resolveBoundedDelta({ value: 10, delta: -5, min: 0, max: 100 });
+ * // → 5
+ *
+ * // Overshoot is clamped to the boundary
+ * resolveBoundedDelta({ value: 2, delta: -10, min: 0, max: 100 });
+ * // → 0
+ *
+ * // Movement blocked at the boundary
+ * resolveBoundedDelta({ value: 0, delta: -5, min: 0, max: 100 });
+ * // → null
+ * ```
+ */
+export declare const resolveBoundedDelta: ({ delta, value, min, max, }: ResolveBoundedDeltaOptions) => Nullable<number>;
+export {};

package/dist/index.cjs

@@ -1,2 +1,2 @@
-(()=>{"use strict";var e={d:(t,n)=>{for(var r in n)e.o(n,r)&&!e.o(t,r)&&Object.defineProperty(t,r,{enumerable:!0,get:n[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={};function n(e,t){if(!e)throw new Error(t)}e.r(t),e.d(t,{FOCUSABLE_HTML_TAGS:()=>xe,assert:()=>n,blobToFile:()=>be,calculateCenterOffset:()=>he,calculateEuclideanDistance:()=>te,calculateMovingSpeed:()=>ne,calculatePercentage:()=>re,camelToDashCase:()=>K,camelToWords:()=>J,centerElementInContainer:()=>me,chunk:()=>F,cloneBlob:()=>ie,compact:()=>E,compose:()=>C,definedProps:()=>Oe,delay:()=>N,difference:()=>T,downloadFile:()=>se,everyAsync:()=>U,fileListToFiles:()=>we,filterParallel:()=>W,filterSequential:()=>z,findAsync:()=>q,getDOMRectIntersectionRatio:()=>ve,getElementOffsetRect:()=>ae,getFocusableHtmlElements:()=>Me,getLocalStorageCapabilities:()=>Ce,getXOverflowWidth:()=>ue,getYOverflowHeight:()=>de,hasXOverflow:()=>ce,hasYOverflow:()=>fe,hashString:()=>ee,intersection:()=>M,invokeIfFunction:()=>D,isAnchorHtmlElement:()=>le,isArray:()=>O,isBlob:()=>d,isBool:()=>s,isContentEditableHtmlElement:()=>oe,isDate:()=>f,isDecimal:()=>A,isDefined:()=>a,isEmptyArray:()=>v,isEmptyObject:()=>u,isError:()=>h,isFile:()=>ge,isFiniteNumber:()=>b,isFunction:()=>_,isHtmlElementFocusable:()=>Fe,isInteger:()=>S,isLocalStorageReadable:()=>Pe,isMap:()=>g,isNil:()=>i,isNilOrEmptyString:()=>V,isNull:()=>r,isNumber:()=>o,isObject:()=>c,isPromise:()=>j,isRegExp:()=>y,isSet:()=>p,isString:()=>G,isSymbol:()=>w,isUndefined:()=>l,isValidDate:()=>m,moveFocusWithinContainer:()=>Te,noop:()=>k,not:()=>L,once:()=>Y,parse2DMatrix:()=>ye,parseFileName:()=>pe,pipe:()=>P,readFilesFromDataTransfer:()=>Ae,reduceAsync:()=>$,resolveAxisDelta:()=>Ee,retry:()=>X,runParallel:()=>I,runSequential:()=>H,someAsync:()=>B,splitStringIntoWords:()=>Q,timeout:()=>R,toKebabCase:()=>Z,traverseFileSystemDirectory:()=>Se,unique:()=>x});const r=e=>null===e,i=e=>null==e,a=e=>null!=e,l=e=>void 0===e,o=e=>"number"==typeof e,s=e=>"boolean"==typeof e,c=e=>"object"==typeof e,u=e=>c(e)&&!r(e)&&0===Object.keys(e).length,f=e=>e instanceof Date,d=e=>e instanceof Blob,h=e=>e instanceof Error,m=e=>f(e)&&!isNaN(e.getTime()),y=e=>e instanceof RegExp,g=e=>e instanceof Map,p=e=>e instanceof Set,w=e=>"symbol"==typeof e,b=e=>o(e)&&isFinite(e),S=e=>o(e)&&Number.isInteger(e),A=e=>b(e)&&!Number.isInteger(e),O=e=>Array.isArray(e),v=e=>O(e)&&0===e.length,E=e=>e.filter(Boolean),x=e=>[...new Set(e)],F=(e,t)=>(n(t>0,"Chunk size must be greater than 0"),Array.from({length:Math.ceil(e.length/t)},(n,r)=>e.slice(r*t,(r+1)*t))),M=(...e)=>{if(0===e.length)return[];if(1===e.length)return[...e[0]];const[t,...n]=e;return x(t).filter(e=>n.every(t=>t.includes(e)))},T=(e,t)=>e.filter(e=>!t.includes(e)),P=(...e)=>t=>e.reduce((e,t)=>t(e),t),C=(...e)=>t=>e.reduceRight((e,t)=>t(e),t),k=()=>{},_=e=>"function"==typeof e,L=e=>(...t)=>!e(...t),D=(e,...t)=>"function"==typeof e?e(...t):e,N=e=>new Promise(t=>setTimeout(t,e)),R=async(e,t,n="Operation timed out")=>{try{return await Promise.race([e,N(t).then(()=>Promise.reject(new Error(n)))])}finally{}},X=(e,{maxAttempts:t=3,delayMs:n=300,backoff:r=!0,onRetry:i}={})=>async(...a)=>{let l;for(let o=1;o<=t;o++)try{return await e(...a)}catch(e){if(l=e,o<t){i?.(o,e);const t=r?n*2**(o-1):n;await N(t)}}throw l},Y=e=>{let t,n=!1;return function(...r){return n||(n=!0,t=e.apply(this,r)),t}},j=e=>_(e?.then),H=async(e,t)=>{const n=[];for(let r=0;r<e.length;r++)n.push(await t(e[r],r,e));return n},I=async(e,t)=>Promise.all(e.map(t)),z=async(e,t)=>{const n=[];for(let r=0;r<e.length;r++){const i=e[r];await t(i,r,e)&&n.push(i)}return n},W=async(e,t)=>{const n=await I(e,async(e,n,r)=>!!await t(e,n,r)&&e);return E(n)},B=async(e,t)=>{for(let n=0;n<e.length;n++)if(await t(e[n],n,e))return!0;return!1},U=async(e,t)=>{for(let n=0;n<e.length;n++)if(!await t(e[n],n,e))return!1;return!0},$=async(e,t,n)=>{let r=n;for(let n=0;n<e.length;n++)r=await t(r,e[n],n,e);return r},q=async(e,t)=>{for(let n=0;n<e.length;n++)if(await t(e[n],n,e))return e[n];return null},G=e=>"string"==typeof e,V=e=>""===e||i(e),Z=e=>e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").toLowerCase(),K=e=>{const t=e.charAt(0),n=e.slice(1);return t.toLowerCase()+n.replace(/[A-Z]/g,e=>`-${e.toLowerCase()}`)},J=e=>e.replace(/([a-z0-9])([A-Z])/g,"$1 $2"),Q=e=>e.split(" ").filter(Boolean),ee=e=>{let t=5381;for(let n=0;n<e.length;n++)t=33*t^e.charCodeAt(n);return(t>>>0).toString(36)},te=(e,t,n,r)=>{const i=n-e,a=r-t;return Math.hypot(i,a)},ne=(e,t)=>Math.abs(e/t),re=(e,t)=>e*t/100,ie=e=>new Blob([e],{type:e.type}),ae=e=>new DOMRect(e.offsetLeft,e.offsetTop,e.clientWidth,e.clientHeight),le=e=>"A"===e.tagName,oe=e=>"true"===e.getAttribute("contenteditable"),se=(e,{fileName:t,target:r}={})=>{if(l(document))return;const i=document.createElement("a");let a=null;try{const n=G(e)?e:a=URL.createObjectURL(e);i.href=n,t&&(i.download=t),r&&(i.target=r),document.body.appendChild(i),i.click()}finally{i.remove(),a&&setTimeout(()=>{n(a,"Object URL should not be null"),URL.revokeObjectURL(a)},0)}},ce=e=>e.scrollWidth>e.clientWidth,ue=e=>Math.max(0,e.scrollWidth-e.clientWidth),fe=e=>e.scrollHeight>e.clientHeight,de=e=>Math.max(0,e.scrollHeight-e.clientHeight),he=({overflowSize:e,containerSize:t,elementOffset:n,elementSize:r})=>{if(e<=0)return 0;const i=n+r/2-t/2;return-Math.max(0,Math.min(i,e))},me=(e,t,{axis:n="both"}={})=>{let r=0,i=0;"x"!==n&&"both"!==n||(r=he({overflowSize:ue(e),containerSize:e.clientWidth,elementOffset:t.offsetLeft,elementSize:t.clientWidth})),"y"!==n&&"both"!==n||(i=he({overflowSize:de(e),containerSize:e.clientHeight,elementOffset:t.offsetTop,elementSize:t.clientHeight})),e.style.transform=`translate(${r}px, ${i}px)`},ye=e=>{const t=window.getComputedStyle(e).getPropertyValue("transform").match(/^matrix\((.+)\)$/);if(!t)return{translateX:0,translateY:0,scaleX:1,scaleY:1,skewX:0,skewY:0};const[n,r,i,a,l,o]=t[1].split(", ").map(parseFloat);return{translateX:l,translateY:o,scaleX:n,scaleY:a,skewX:i,skewY:r}},ge=e=>e instanceof File,pe=e=>{const t=e.lastIndexOf(".");return t<=0||t===e.length-1?[e,""]:[e.slice(0,t),e.slice(t+1).toLowerCase()]},we=e=>{if(!e)return[];const t=[];for(let n=0;n<e.length;n++)t.push(e[n]);return t},be=(e,t)=>new File([e],t,{type:e.type}),Se=async(e,{skipFiles:t=[".DS_Store","Thumbs.db","desktop.ini","ehthumbs.db",".Spotlight-V100",".Trashes",".fseventsd","__MACOSX"]}={})=>{const n=new Set(t),r=await(async e=>{const t=e.createReader(),n=async()=>new Promise((e,r)=>{t.readEntries(async t=>{if(t.length)try{const r=await n();e([...t,...r])}catch(e){r(e)}else e([])},r)});return n()})(e);return(await I(r,async e=>e.isDirectory?Se(e,{skipFiles:t}):n.has(e.name)?[]:[await new Promise((t,n)=>{e.file(t,n)})])).flat()},Ae=async(e,t={})=>{const n=e?.items;if(!n)return[];const r=[];for(let e=0;e<n.length;e++){const i=n[e];if("webkitGetAsEntry"in i){const e=i.webkitGetAsEntry?.();if(e?.isDirectory){r.push(Se(e,t));continue}if(e?.isFile){r.push(new Promise((t,n)=>e.file(e=>t([e]),n)));continue}}const a=i.getAsFile();a&&r.push(Promise.resolve([a]))}return(await Promise.all(r)).flat()},Oe=e=>Object.entries(e).reduce((e,[t,n])=>(void 0!==n&&(e[t]=n),e),{}),ve=(e,t)=>Math.max(0,Math.min(e.right,t.right)-Math.max(e.left,t.left))*Math.max(0,Math.min(e.bottom,t.bottom)-Math.max(e.top,t.top))/(t.width*t.height),Ee=(e,t,{allowFallback:n=!0,invert:r=!0}={})=>{const i=r?-1:1;switch(t){case"x":return{deltaX:i*(0!==e.deltaX?e.deltaX:n?e.deltaY:0),deltaY:0};case"y":return{deltaX:0,deltaY:i*e.deltaY};default:return{deltaX:i*e.deltaX,deltaY:i*e.deltaY}}},xe=["INPUT","SELECT","TEXTAREA","BUTTON","A"],Fe=e=>{if(!e)return!1;const t=window.getComputedStyle(e);if("hidden"===t.visibility||"none"===t.display)return!1;if("disabled"in e&&e.disabled)return!1;const n=e.getAttribute("tabindex");return"-1"!==n&&(xe.includes(e.tagName)?!le(e)||""!==e.href:!!oe(e)||null!==n)},Me=e=>Array.from(e.querySelectorAll("*")).filter(Fe),Te=(e,t=null,{wrap:n=!0,getNextIndex:r}={})=>{const i=document.activeElement,a=t??i?.parentElement;if(!i||!a)return;const l=Me(a);if(0===l.length)return;const o=l.indexOf(i);if(-1===o)return;let s;r?s=r(o,e,l):"next"===e?(s=o+1,s>=l.length&&(s=n?0:null)):(s=o-1,s<0&&(s=n?l.length-1:null)),null!==s&&l[s]?.focus()},Pe=()=>{if("undefined"==typeof window||!window.localStorage)return!1;try{return window.localStorage.getItem("__non_existing_key__"),!0}catch{return!1}},Ce=()=>{if(!Pe())return{readable:!1,writable:!1};try{const e="__test_write__";return window.localStorage.setItem(e,"1"),window.localStorage.removeItem(e),{readable:!0,writable:!0}}catch{}return{readable:!0,writable:!1}};module.exports=t})();
+(()=>{"use strict";var e={d:(t,n)=>{for(var r in n)e.o(n,r)&&!e.o(t,r)&&Object.defineProperty(t,r,{enumerable:!0,get:n[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={};function n(e,t){if(!e)throw new Error(t)}e.r(t),e.d(t,{FOCUSABLE_HTML_TAGS:()=>Fe,applyInertiaStep:()=>Oe,assert:()=>n,blobToFile:()=>be,calculateCenterOffset:()=>he,calculateEuclideanDistance:()=>te,calculateMovingSpeed:()=>ne,calculatePercentage:()=>re,camelToDashCase:()=>G,camelToWords:()=>Z,centerElementInContainer:()=>ye,chunk:()=>M,cloneBlob:()=>le,compact:()=>O,compose:()=>C,definedProps:()=>xe,delay:()=>B,difference:()=>T,downloadFile:()=>ce,everyAsync:()=>H,fileListToFiles:()=>we,filterParallel:()=>Y,filterSequential:()=>I,findAsync:()=>W,getDOMRectIntersectionRatio:()=>Ee,getElementOffsetRect:()=>ae,getFocusableHtmlElements:()=>Pe,getLocalStorageCapabilities:()=>_e,getXOverflowWidth:()=>fe,getYOverflowHeight:()=>de,hasXOverflow:()=>ue,hasYOverflow:()=>me,hashString:()=>ie,intersection:()=>F,invokeIfFunction:()=>ee,isAnchorHtmlElement:()=>oe,isArray:()=>x,isBlob:()=>m,isBool:()=>s,isContentEditableHtmlElement:()=>se,isDate:()=>f,isDecimal:()=>v,isDefined:()=>l,isEmptyArray:()=>A,isEmptyObject:()=>u,isError:()=>d,isFile:()=>pe,isFiniteNumber:()=>b,isFunction:()=>_,isHtmlElementFocusable:()=>Te,isInteger:()=>S,isLocalStorageReadable:()=>ke,isMap:()=>g,isNil:()=>i,isNilOrEmptyString:()=>J,isNull:()=>r,isNumber:()=>o,isObject:()=>c,isPromise:()=>N,isRegExp:()=>y,isSet:()=>p,isString:()=>q,isSymbol:()=>w,isUndefined:()=>a,isValidDate:()=>h,moveFocusWithinContainer:()=>Ce,noop:()=>k,not:()=>D,once:()=>L,parse2DMatrix:()=>ge,parseFileName:()=>Q,pipe:()=>P,readFilesFromDataTransfer:()=>ve,reduceAsync:()=>z,resolveAxisDelta:()=>Me,resolveBoundedDelta:()=>Ae,retry:()=>$,runParallel:()=>X,runSequential:()=>R,someAsync:()=>j,splitStringIntoWords:()=>K,timeout:()=>U,toKebabCase:()=>V,traverseFileSystemDirectory:()=>Se,unique:()=>E});const r=e=>null===e,i=e=>null==e,l=e=>null!=e,a=e=>void 0===e,o=e=>"number"==typeof e,s=e=>"boolean"==typeof e,c=e=>"object"==typeof e,u=e=>c(e)&&!r(e)&&0===Object.keys(e).length,f=e=>e instanceof Date,m=e=>e instanceof Blob,d=e=>e instanceof Error,h=e=>f(e)&&!isNaN(e.getTime()),y=e=>e instanceof RegExp,g=e=>e instanceof Map,p=e=>e instanceof Set,w=e=>"symbol"==typeof e,b=e=>o(e)&&isFinite(e),S=e=>o(e)&&Number.isInteger(e),v=e=>b(e)&&!Number.isInteger(e),x=e=>Array.isArray(e),A=e=>x(e)&&0===e.length,O=e=>e.filter(Boolean),E=e=>[...new Set(e)],M=(e,t)=>(n(t>0,"Chunk size must be greater than 0"),Array.from({length:Math.ceil(e.length/t)},(n,r)=>e.slice(r*t,(r+1)*t))),F=(...e)=>{if(0===e.length)return[];if(1===e.length)return[...e[0]];const[t,...n]=e;return E(t).filter(e=>n.every(t=>t.includes(e)))},T=(e,t)=>e.filter(e=>!t.includes(e)),P=(...e)=>t=>e.reduce((e,t)=>t(e),t),C=(...e)=>t=>e.reduceRight((e,t)=>t(e),t),k=()=>{},_=e=>"function"==typeof e,D=e=>(...t)=>!e(...t),L=e=>{let t,n=!1;return function(...r){return n||(n=!0,t=e.apply(this,r)),t}},N=e=>_(e?.then),R=async(e,t)=>{const n=[];for(let r=0;r<e.length;r++)n.push(await t(e[r],r,e));return n},X=async(e,t)=>Promise.all(e.map(t)),I=async(e,t)=>{const n=[];for(let r=0;r<e.length;r++){const i=e[r];await t(i,r,e)&&n.push(i)}return n},Y=async(e,t)=>{const n=await X(e,async(e,n,r)=>!!await t(e,n,r)&&e);return O(n)},j=async(e,t)=>{for(let n=0;n<e.length;n++)if(await t(e[n],n,e))return!0;return!1},H=async(e,t)=>{for(let n=0;n<e.length;n++)if(!await t(e[n],n,e))return!1;return!0},z=async(e,t,n)=>{let r=n;for(let n=0;n<e.length;n++)r=await t(r,e[n],n,e);return r},W=async(e,t)=>{for(let n=0;n<e.length;n++)if(await t(e[n],n,e))return e[n];return null},B=e=>new Promise(t=>setTimeout(t,e)),U=async(e,t,n="Operation timed out")=>{try{return await Promise.race([e,B(t).then(()=>Promise.reject(new Error(n)))])}finally{}},$=(e,{maxAttempts:t=3,delayMs:n=300,backoff:r=!0,onRetry:i}={})=>async(...l)=>{let a;for(let o=1;o<=t;o++)try{return await e(...l)}catch(e){if(a=e,o<t){i?.(o,e);const t=r?n*2**(o-1):n;await B(t)}}throw a},q=e=>"string"==typeof e,V=e=>e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").toLowerCase(),G=e=>{const t=e.charAt(0),n=e.slice(1);return t.toLowerCase()+n.replace(/[A-Z]/g,e=>`-${e.toLowerCase()}`)},Z=e=>e.replace(/([a-z0-9])([A-Z])/g,"$1 $2"),K=e=>e.split(" ").filter(Boolean),J=e=>""===e||i(e),Q=e=>{const t=e.lastIndexOf(".");return t<=0||t===e.length-1?[e,""]:[e.slice(0,t),e.slice(t+1).toLowerCase()]},ee=(e,...t)=>"function"==typeof e?e(...t):e,te=(e,t,n,r)=>{const i=n-e,l=r-t;return Math.hypot(i,l)},ne=(e,t)=>Math.abs(e/t),re=(e,t)=>e*t/100,ie=e=>{let t=5381;for(let n=0;n<e.length;n++)t=33*t^e.charCodeAt(n);return(t>>>0).toString(36)},le=e=>new Blob([e],{type:e.type}),ae=e=>new DOMRect(e.offsetLeft,e.offsetTop,e.clientWidth,e.clientHeight),oe=e=>"A"===e.tagName,se=e=>"true"===e.getAttribute("contenteditable"),ce=(e,{fileName:t,target:r}={})=>{if(a(document))return;const i=document.createElement("a");let l=null;try{const n=q(e)?e:l=URL.createObjectURL(e);i.href=n,t&&(i.download=t),r&&(i.target=r),document.body.appendChild(i),i.click()}finally{i.remove(),l&&setTimeout(()=>{n(l,"Object URL should not be null"),URL.revokeObjectURL(l)},0)}},ue=e=>e.scrollWidth>e.clientWidth,fe=e=>Math.max(0,e.scrollWidth-e.clientWidth),me=e=>e.scrollHeight>e.clientHeight,de=e=>Math.max(0,e.scrollHeight-e.clientHeight),he=({overflowSize:e,containerSize:t,elementOffset:n,elementSize:r})=>{if(e<=0)return 0;const i=n+r/2-t/2;return-Math.max(0,Math.min(i,e))},ye=(e,t,{axis:n="both"}={})=>{let r=0,i=0;"x"!==n&&"both"!==n||(r=he({overflowSize:fe(e),containerSize:e.clientWidth,elementOffset:t.offsetLeft,elementSize:t.clientWidth})),"y"!==n&&"both"!==n||(i=he({overflowSize:de(e),containerSize:e.clientHeight,elementOffset:t.offsetTop,elementSize:t.clientHeight})),e.style.transform=`translate(${r}px, ${i}px)`},ge=e=>{const t=window.getComputedStyle(e).getPropertyValue("transform").match(/^matrix\((.+)\)$/);if(!t)return{translateX:0,translateY:0,scaleX:1,scaleY:1,skewX:0,skewY:0};const[n,r,i,l,a,o]=t[1].split(", ").map(parseFloat);return{translateX:a,translateY:o,scaleX:n,scaleY:l,skewX:i,skewY:r}},pe=e=>e instanceof File,we=e=>{if(!e)return[];const t=[];for(let n=0;n<e.length;n++)t.push(e[n]);return t},be=(e,t)=>new File([e],t,{type:e.type}),Se=async(e,{skipFiles:t=[".DS_Store","Thumbs.db","desktop.ini","ehthumbs.db",".Spotlight-V100",".Trashes",".fseventsd","__MACOSX"]}={})=>{const n=new Set(t),r=await(async e=>{const t=e.createReader(),n=async()=>new Promise((e,r)=>{t.readEntries(async t=>{if(t.length)try{const r=await n();e([...t,...r])}catch(e){r(e)}else e([])},r)});return n()})(e);return(await X(r,async e=>e.isDirectory?Se(e,{skipFiles:t}):n.has(e.name)?[]:[await new Promise((t,n)=>{e.file(t,n)})])).flat()},ve=async(e,t={})=>{const n=e?.items;if(!n)return[];const r=[];for(let e=0;e<n.length;e++){const i=n[e];if("webkitGetAsEntry"in i){const e=i.webkitGetAsEntry?.();if(e?.isDirectory){r.push(Se(e,t));continue}if(e?.isFile){r.push(new Promise((t,n)=>e.file(e=>t([e]),n)));continue}}const l=i.getAsFile();l&&r.push(Promise.resolve([l]))}return(await Promise.all(r)).flat()},xe=e=>Object.entries(e).reduce((e,[t,n])=>(void 0!==n&&(e[t]=n),e),{}),Ae=({delta:e,value:t,min:n,max:r})=>{if(0===e)return null;const i=t+e;return e<0?t<=n?null:Math.max(i,n):e>0?t>=r?null:Math.min(i,r):null},Oe=({value:e,min:t,max:n,velocity:r,deltaTime:i,friction:l=.002,minVelocity:a=.01})=>{if(Math.abs(r)<a)return null;const o=Ae({delta:r*i,value:e,min:t,max:n});return null===o?null:{value:o,velocity:r*Math.exp(-l*i)}},Ee=(e,t)=>Math.max(0,Math.min(e.right,t.right)-Math.max(e.left,t.left))*Math.max(0,Math.min(e.bottom,t.bottom)-Math.max(e.top,t.top))/(t.width*t.height),Me=(e,t,{allowFallback:n=!0,invert:r=!0}={})=>{const i=r?-1:1;switch(t){case"x":return{deltaX:i*(0!==e.deltaX?e.deltaX:n?e.deltaY:0),deltaY:0};case"y":return{deltaX:0,deltaY:i*e.deltaY};default:return{deltaX:i*e.deltaX,deltaY:i*e.deltaY}}},Fe=["INPUT","SELECT","TEXTAREA","BUTTON","A"],Te=e=>{if(!e)return!1;const t=window.getComputedStyle(e);if("hidden"===t.visibility||"none"===t.display)return!1;if("disabled"in e&&e.disabled)return!1;const n=e.getAttribute("tabindex");return"-1"!==n&&(Fe.includes(e.tagName)?!oe(e)||""!==e.href:!!se(e)||null!==n)},Pe=e=>Array.from(e.querySelectorAll("*")).filter(Te),Ce=(e,t=null,{wrap:n=!0,getNextIndex:r}={})=>{const i=document.activeElement,l=t??i?.parentElement;if(!i||!l)return;const a=Pe(l);if(0===a.length)return;const o=a.indexOf(i);if(-1===o)return;let s;r?s=r(o,e,a):"next"===e?(s=o+1,s>=a.length&&(s=n?0:null)):(s=o-1,s<0&&(s=n?a.length-1:null)),null!==s&&a[s]?.focus()},ke=()=>{if("undefined"==typeof window||!window.localStorage)return!1;try{return window.localStorage.getItem("__non_existing_key__"),!0}catch{return!1}},_e=()=>{if(!ke())return{readable:!1,writable:!1};try{const e="__test_write__";return window.localStorage.setItem(e,"1"),window.localStorage.removeItem(e),{readable:!0,writable:!0}}catch{}return{readable:!0,writable:!1}};module.exports=t})();
 //# sourceMappingURL=index.cjs.map