@react-md/core 1.0.0-next.12 → 1.0.0-next.13

package/dist/form/fileUtils.d.ts

@@ -1,5 +1,5 @@
 import { type ChangeEventHandler, type DragEventHandler } from "react";
-/** @remarks \@since 2.9.0 */
+/** @since 2.9.0 */
 export interface BaseFileUploadStats {
     /**
      * A unique key associated with each upload generated by `nanoid`.
@@ -14,13 +14,13 @@ export interface BaseFileUploadStats {
      */
     progress: number;
 }
-/** @remarks \@since 2.9.0 */
+/** @since 2.9.0 */
 export interface ProcessingFileUploadStats extends BaseFileUploadStats {
     status: "pending" | "uploading";
 }
-/** @remarks \@since 2.9.0 */
+/** @since 2.9.0 */
 export type FileReaderResult = FileReader["result"];
-/** @remarks \@since 2.9.0 */
+/** @since 2.9.0 */
 export interface CompletedFileUploadStats extends BaseFileUploadStats {
     status: "complete";
     /**
@@ -35,11 +35,11 @@ export interface CompletedFileUploadStats extends BaseFileUploadStats {
      */
     result: FileReaderResult;
 }
-/** @remarks \@since 2.9.0 */
+/** @since 2.9.0 */
 export type FileUploadStats = ProcessingFileUploadStats | CompletedFileUploadStats;
-/** @remarks \@since 2.9.0 */
+/** @since 2.9.0 */
 export type FileUploadStatus = FileUploadStats["status"];
-/** @remarks \@since 2.9.0 */
+/** @since 2.9.0 */
 export interface FileUploadHandlers<E extends HTMLElement> {
     onDrop?: DragEventHandler<E>;
     onChange?: ChangeEventHandler<HTMLInputElement>;
@@ -49,7 +49,7 @@ export interface FileUploadHandlers<E extends HTMLElement> {
  * from a shared directory that they do not have access to. This error will not
  * occur much.
  *
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export declare class FileAccessError extends Error {
     /**
@@ -65,7 +65,7 @@ export declare class FileAccessError extends Error {
 /**
  * An error that just requires a `File` to be passed as the first argument.
  *
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export declare class GenericFileError extends Error {
     files: readonly File[];
@@ -85,7 +85,7 @@ export declare class GenericFileError extends Error {
  * An error that is created during the upload process if the number of files
  * exceeds the {@link FileUploadOptions.maxFiles} amount.
  *
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export declare class TooManyFilesError extends GenericFileError {
     limit: number;
@@ -104,7 +104,7 @@ export declare class TooManyFilesError extends GenericFileError {
  * - greater than the {@link FileValidationOptions.maxFileSize}
  * - including the file would be greater than the {@link FileValidationOptions.totalFileSize}
  *
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export declare class FileSizeError extends GenericFileError {
     type: "min" | "max" | "total";
@@ -121,7 +121,7 @@ export declare class FileSizeError extends GenericFileError {
  * An error that will be created if a user tries to upload a file that does not
  * end with one of the {@link FileValidationOptions.extensions}.
  *
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export declare class FileExtensionError extends GenericFileError {
     extensions: readonly string[];
@@ -135,7 +135,7 @@ export declare class FileExtensionError extends GenericFileError {
 /**
  * Mostly an internal type that is used to allow custom validation errors
  *
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export type FileValidationError<E = GenericFileError> = FileAccessError | TooManyFilesError | FileSizeError | FileExtensionError | E;
 /**
@@ -194,16 +194,16 @@ export declare function isFileExtensionError<CustomError extends {}>(error: File
  * `extensions` list had at least one value.
  * @param extensions - The list of extensions allowed
  * @returns true if the file has a valid name.
- * @remarks \@since 3.1.0
+ * @since 3.1.0
  */
 export type IsValidFileName = (file: File, extensionRegExp: RegExp | undefined, extensions: readonly string[]) => boolean;
 /**
  *
  * @defaultValue `matcher?.test(file.name) ?? true`
- * @remarks \@since 3.1.0
+ * @since 3.1.0
  */
 export declare const isValidFileName: IsValidFileName;
-/** @remarks \@since 2.9.0 */
+/** @since 2.9.0 */
 export interface FileValidationOptions {
     /**
      * If the number of files should be limited, set this value to a number
@@ -235,8 +235,7 @@ export interface FileValidationOptions {
      *
      * Note: The extensions and file names will be compared ignoring case.
      *
-     * @example
-     * Only Allow Images
+     * @example Only Allow Images
      * ```ts
      * const extensions = ["png", "jpeg", "jpg", "gif"];
      * ```
@@ -252,7 +251,7 @@ export interface FileValidationOptions {
      */
     totalFileSize?: number;
 }
-/** @remarks \@since 2.9.0 */
+/** @since 2.9.0 */
 export interface FilesValidationOptions extends Required<FileValidationOptions> {
     /**
      * The total number of bytes in the {@link FileUploadHookReturnValue.stats}
@@ -268,7 +267,7 @@ export interface FilesValidationOptions extends Required<FileValidationOptions>
      */
     totalFiles: number;
 }
-/** @remarks \@since 2.9.0 */
+/** @since 2.9.0 */
 export interface ValidatedFilesResult<CustomError> {
     /**
      * A filtered list of files that have been validated and can be queued for the
@@ -288,8 +287,7 @@ export interface ValidatedFilesResult<CustomError> {
  * This function will be called whenever a file has been uploaded by the user
  * either through an `<input type="file">` or drag and drop behavior.
  *
- * @example
- * Simple Example
+ * @example Simple Example
  * ```ts
  * const validateFiles: FilesValidator = (files, options) => {
  *   const invalid: File[] = [];
@@ -316,7 +314,7 @@ export interface ValidatedFilesResult<CustomError> {
  * @param options - The {@link FilesValidationOptions}
  * @returns the {@link ValidatedFilesResult}
  * @see {@link validateFiles} for the default implementation
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export type FilesValidator<CustomError = never> = (files: readonly File[], options: FilesValidationOptions) => ValidatedFilesResult<CustomError>;
 /**
@@ -328,7 +326,7 @@ export type FilesValidator<CustomError = never> = (files: readonly File[], optio
  * @param files - The list of files to check
  * @param options - The {@link FilesValidationOptions}
  * @returns the {@link ValidatedFilesResult}
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export declare function validateFiles<CustomError>(files: readonly File[], { maxFiles, extensions, minFileSize, maxFileSize, totalBytes, totalFiles, totalFileSize, isValidFileName, }: FilesValidationOptions): ValidatedFilesResult<CustomError>;
 /**
@@ -341,7 +339,7 @@ export declare function validateFiles<CustomError>(files: readonly File[], { max
  *
  * @param file - The file to check
  * @returns `true` if the file should be considered as a text-content file.
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export declare function isTextFile(file: File): boolean;
 /**
@@ -354,7 +352,7 @@ export declare function isTextFile(file: File): boolean;
  *
  * @param file - The file to check
  * @returns `true` if the file should be considered as a text content file.
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export declare function isImageFile(file: File): boolean;
 /**
@@ -367,7 +365,7 @@ export declare function isImageFile(file: File): boolean;
  *
  * @param file - The file to check
  * @returns `true` if the file should be considered as a audio content file.
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export declare function isAudioFile(file: File): boolean;
 /**
@@ -380,7 +378,7 @@ export declare function isAudioFile(file: File): boolean;
  *
  * @param file - The file to check
  * @returns `true` if the file should be considered as a video content file.
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export declare function isVideoFile(file: File): boolean;
 /**
@@ -389,7 +387,7 @@ export declare function isVideoFile(file: File): boolean;
  *
  * @param file - The file to check
  * @returns `true` if the file matches an image, audio, or video file.
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export declare function isMediaFile(file: File): boolean;
 /**
@@ -399,15 +397,14 @@ export declare function isMediaFile(file: File): boolean;
  * Note: If this file does not need to be previewed in the browser and will
  * immediately be uploaded to a server, use `readAsArrayBuffer`.
  *
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export type FileReaderParser = "readAsText" | "readAsDataURL" | "readAsBinaryString" | "readAsArrayBuffer";
 /**
  * A function that should return one of the {@link FileReaderParser} functions
  * to start uploading a file to the browser.
  *
- * @example
- * The Default File Upload Parser
+ * @example The Default File Upload Parser
  * ```ts
  * export const getFileParser: GetFileParser = (file) => {
  *   if (isMediaFile(file)) {
@@ -424,7 +421,7 @@ export type FileReaderParser = "readAsText" | "readAsDataURL" | "readAsBinaryStr
  *
  * @param file - The file to get a parser for
  * @returns the {@link FileReaderParser} string.
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export type GetFileParser = (file: File) => FileReaderParser;
 /**
@@ -435,10 +432,10 @@ export type GetFileParser = (file: File) => FileReaderParser;
  * - everything else as an `ArrayBuffer` which can be manually converted into a
  *   data url if needed with `URL.createObjectURL`
  *
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export declare const getFileParser: GetFileParser;
-/** @remarks \@since 2.9.0 */
+/** @since 2.9.0 */
 export interface SplitFileUploads {
     readonly pending: readonly ProcessingFileUploadStats[];
     readonly uploading: readonly ProcessingFileUploadStats[];
@@ -450,6 +447,6 @@ export interface SplitFileUploads {
  * @param stats - The {@link FileUploadStats} list generally returned by the
  * {@link useFileUpload} hook.
  * @returns the {@link SplitFileUploads}.
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */
 export declare function getSplitFileUploads(stats: readonly FileUploadStats[]): SplitFileUploads;

package/dist/form/fileUtils.js

@@ -17,7 +17,7 @@ import { nanoid } from "nanoid";
  * from a shared directory that they do not have access to. This error will not
  * occur much.
  *
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */ export class FileAccessError extends Error {
     /**
    *
@@ -34,7 +34,7 @@ import { nanoid } from "nanoid";
 /**
  * An error that just requires a `File` to be passed as the first argument.
  *
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */ export class GenericFileError extends Error {
     /**
    *
@@ -57,7 +57,7 @@ import { nanoid } from "nanoid";
  * An error that is created during the upload process if the number of files
  * exceeds the {@link FileUploadOptions.maxFiles} amount.
  *
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */ export class TooManyFilesError extends GenericFileError {
     /**
    *
@@ -78,7 +78,7 @@ import { nanoid } from "nanoid";
  * - greater than the {@link FileValidationOptions.maxFileSize}
  * - including the file would be greater than the {@link FileValidationOptions.totalFileSize}
  *
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */ export class FileSizeError extends GenericFileError {
     /**
    *
@@ -98,7 +98,7 @@ import { nanoid } from "nanoid";
  * An error that will be created if a user tries to upload a file that does not
  * end with one of the {@link FileValidationOptions.extensions}.
  *
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */ export class FileExtensionError extends GenericFileError {
     /**
    *
@@ -164,7 +164,7 @@ import { nanoid } from "nanoid";
 /**
  *
  * @defaultValue `matcher?.test(file.name) ?? true`
- * @remarks \@since 3.1.0
+ * @since 3.1.0
  */ export const isValidFileName = (file, matcher)=>matcher?.test(file.name) ?? true;
 /**
  * A pretty decent default implementation for validating files with the
@@ -175,7 +175,7 @@ import { nanoid } from "nanoid";
  * @param files - The list of files to check
  * @param options - The {@link FilesValidationOptions}
  * @returns the {@link ValidatedFilesResult}
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */ export function validateFiles(files, { maxFiles, extensions, minFileSize, maxFileSize, totalBytes, totalFiles, totalFileSize, isValidFileName }) {
     const errors = [];
     const pending = [];
@@ -245,7 +245,7 @@ import { nanoid } from "nanoid";
  *
  * @param file - The file to check
  * @returns `true` if the file should be considered as a text-content file.
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */ export function isTextFile(file) {
     return /\.((j|t)sx?|json|lock|hbs|ya?ml|log|txt|md)$/i.test(file.name);
 }
@@ -259,7 +259,7 @@ import { nanoid } from "nanoid";
  *
  * @param file - The file to check
  * @returns `true` if the file should be considered as a text content file.
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */ export function isImageFile(file) {
     return /\.(a?png|avif|svg|tiff|gifv?|jpe?g)/i.test(file.name);
 }
@@ -273,7 +273,7 @@ import { nanoid } from "nanoid";
  *
  * @param file - The file to check
  * @returns `true` if the file should be considered as a audio content file.
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */ export function isAudioFile(file) {
     return /\.(mp3|wav|ogg|m4p|flac)$/i.test(file.name);
 }
@@ -287,7 +287,7 @@ import { nanoid } from "nanoid";
  *
  * @param file - The file to check
  * @returns `true` if the file should be considered as a video content file.
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */ export function isVideoFile(file) {
     return /\.(mkv|mpe?g|mov|avi|flv|webm|mp4)$/i.test(file.name);
 }
@@ -297,7 +297,7 @@ import { nanoid } from "nanoid";
  *
  * @param file - The file to check
  * @returns `true` if the file matches an image, audio, or video file.
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */ export function isMediaFile(file) {
     return isImageFile(file) || isAudioFile(file) || isVideoFile(file);
 }
@@ -309,7 +309,7 @@ import { nanoid } from "nanoid";
  * - everything else as an `ArrayBuffer` which can be manually converted into a
  *   data url if needed with `URL.createObjectURL`
  *
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */ export const getFileParser = (file)=>{
     if (isMediaFile(file)) {
         return "readAsDataURL";
@@ -325,7 +325,7 @@ import { nanoid } from "nanoid";
  * @param stats - The {@link FileUploadStats} list generally returned by the
  * {@link useFileUpload} hook.
  * @returns the {@link SplitFileUploads}.
- * @remarks \@since 2.9.0
+ * @since 2.9.0
  */ export function getSplitFileUploads(stats) {
     const pending = [];
     const uploading = [];

package/dist/form/fileUtils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/form/fileUtils.ts"],"sourcesContent":["import { nanoid } from \"nanoid\";\nimport { type ChangeEventHandler, type DragEventHandler } from \"react\";\n\n/** @remarks \\@since 2.9.0 */\nexport interface BaseFileUploadStats {\n  /**\n   * A unique key associated with each upload generated by `nanoid`.\n   */\n  key: string;\n\n  /**\n   * The file instance that is being uploaded.\n   */\n  file: File;\n\n  /**\n   * The current upload progress as a percentage from 0 - 100 percent.\n   */\n  progress: number;\n}\n\n/** @remarks \\@since 2.9.0 */\nexport interface ProcessingFileUploadStats extends BaseFileUploadStats {\n  status: \"pending\" | \"uploading\";\n}\n\n/** @remarks \\@since 2.9.0 */\nexport type FileReaderResult = FileReader[\"result\"];\n\n/** @remarks \\@since 2.9.0 */\nexport interface CompletedFileUploadStats extends BaseFileUploadStats {\n  status: \"complete\";\n\n  /**\n   * The result after a `FileReader` has read a file completely.\n   *\n   * Note: This _should_ be an `ArrayBuffer` if the next step is to upload to a\n   * server.\n   *\n   * @see {@link FileReaderParser}\n   * @see {@link getFileParser}\n   * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileReader | FileReader}\n   */\n  result: FileReaderResult;\n}\n\n/** @remarks \\@since 2.9.0 */\nexport type FileUploadStats =\n  | ProcessingFileUploadStats\n  | CompletedFileUploadStats;\n\n/** @remarks \\@since 2.9.0 */\nexport type FileUploadStatus = FileUploadStats[\"status\"];\n\n/** @remarks \\@since 2.9.0 */\nexport interface FileUploadHandlers<E extends HTMLElement> {\n  onDrop?: DragEventHandler<E>;\n  onChange?: ChangeEventHandler<HTMLInputElement>;\n}\n\n/**\n * An error that will be created if a user tries dragging and dropping files\n * from a shared directory that they do not have access to. This error will not\n * occur much.\n *\n * @remarks \\@since 2.9.0\n */\nexport class FileAccessError extends Error {\n  /**\n   * A unique key generated by `nanoid` that can be used as a `React` key\n   */\n  public key: string;\n\n  /**\n   *\n   * @param message - An optional message for the error.\n   */\n  constructor(message?: string) {\n    super(message);\n    this.key = nanoid();\n    this.name = \"FileAccessError\";\n  }\n}\n\n/**\n * An error that just requires a `File` to be passed as the first argument.\n *\n * @remarks \\@since 2.9.0\n */\nexport class GenericFileError extends Error {\n  /**\n   * A unique key generated by `nanoid` that can be used as a `React` key\n   */\n  public key: string;\n\n  /**\n   *\n   * @param files - A list of files that caused the error.\n   * @param reason - An optional reason for the error\n   */\n  constructor(\n    public files: readonly File[],\n    public reason?: string\n  ) {\n    super(\"Invalid files\");\n    this.key = nanoid();\n    this.name = \"GenericFileError\";\n  }\n}\n\n/**\n * An error that is created during the upload process if the number of files\n * exceeds the {@link FileUploadOptions.maxFiles} amount.\n *\n * @remarks \\@since 2.9.0\n */\nexport class TooManyFilesError extends GenericFileError {\n  /**\n   *\n   * @param files - The list of files that could not be uploaded due to the file\n   * limit defined.\n   * @param limit - The max limit of files allowed.\n   */\n  constructor(\n    files: readonly File[],\n    public limit: number\n  ) {\n    super(files, \"file limit\");\n    this.name = \"TooManyFilesError\";\n  }\n}\n\n/**\n * An error that will be created if a user tries to upload a file that\n * is either:\n * - less than the {@link FileValidationOptions.minFileSize}\n * - greater than the {@link FileValidationOptions.maxFileSize}\n * - including the file would be greater than the {@link FileValidationOptions.totalFileSize}\n *\n * @remarks \\@since 2.9.0\n */\nexport class FileSizeError extends GenericFileError {\n  /**\n   *\n   * @param files - The list of files that have the file size error\n   * @param type - The file size error type\n   * @param limit - The number of bytes allowed based on the type\n   */\n  constructor(\n    files: readonly File[],\n    public type: \"min\" | \"max\" | \"total\",\n    public limit: number\n  ) {\n    super(files, \"file size\");\n    this.name = \"FileSizeError\";\n  }\n}\n\n/**\n * An error that will be created if a user tries to upload a file that does not\n * end with one of the {@link FileValidationOptions.extensions}.\n *\n * @remarks \\@since 2.9.0\n */\nexport class FileExtensionError extends GenericFileError {\n  /**\n   *\n   * @param files - The file that caused the error\n   * @param extensions - The allowed list of file extensions\n   */\n  constructor(\n    files: readonly File[],\n    public extensions: readonly string[]\n  ) {\n    super(files, \"extension\");\n    this.name = \"FileExtensionError\";\n  }\n}\n\n/**\n * Mostly an internal type that is used to allow custom validation errors\n *\n * @remarks \\@since 2.9.0\n */\nexport type FileValidationError<E = GenericFileError> =\n  | FileAccessError\n  | TooManyFilesError\n  | FileSizeError\n  | FileExtensionError\n  | E;\n\n/**\n * A simple type-guard that can be used to check if the\n * {@link FileValidationError} is the {@link GenericFileError} which can be\n * useful when displaying the errors to the user.\n *\n * @param error - The error to check\n * @returns true if the error is a {@link FileAccessError}\n */\nexport function isGenericFileError<CustomError extends {}>(\n  error: FileValidationError<CustomError>\n): error is GenericFileError {\n  return \"name\" in error && error.name === \"GenericFileError\";\n}\n\n/**\n * A simple type-guard that can be used to check if the\n * {@link FileValidationError} is the {@link FileAccessError} which can be\n * useful when displaying the errors to the user.\n *\n * @param error - The error to check\n * @returns true if the error is a {@link FileAccessError}\n */\nexport function isFileAccessError<CustomError extends {}>(\n  error: FileValidationError<CustomError>\n): error is FileAccessError {\n  return \"name\" in error && error.name === \"FileAccessError\";\n}\n\n/**\n * A simple type-guard that can be used to check if the\n * {@link FileValidationError} is the {@link TooManyFilesError} which can be\n * useful when displaying the errors to the user.\n *\n * @param error - The error to check\n * @returns true if the error is a {@link TooManyFilesError}\n */\nexport function isTooManyFilesError<CustomError extends {}>(\n  error: FileValidationError<CustomError>\n): error is TooManyFilesError {\n  return \"name\" in error && error.name === \"TooManyFilesError\";\n}\n\n/**\n * A simple type-guard that can be used to check if the\n * {@link FileValidationError} is the {@link FileSizeError} which can be\n * useful when displaying the errors to the user.\n *\n * @param error - The error to check\n * @returns true if the error is a {@link FileSizeError}\n */\nexport function isFileSizeError<CustomError extends {}>(\n  error: FileValidationError<CustomError>\n): error is FileSizeError {\n  return \"name\" in error && error.name === \"FileSizeError\";\n}\n\n/**\n * A simple type-guard that can be used to check if the\n * {@link FileValidationError} is the {@link FileExtensionError} which can be\n * useful when displaying the errors to the user.\n *\n * @param error - The error to check\n * @returns true if the error is a {@link FileExtensionError}\n */\nexport function isFileExtensionError<CustomError extends {}>(\n  error: FileValidationError<CustomError>\n): error is FileExtensionError {\n  return \"name\" in error && error.name === \"FileExtensionError\";\n}\n\n/**\n * This function is used to determine if a file should be added to the\n * {@link FileExtensionError}. The default implementation should work for most\n * use cases except when files that do not have extensions can be uploaded. i.e.\n * LICENSE files.\n *\n * @param file - The file being checked\n * @param extensionRegExp - A regex that will only be defined if the\n * `extensions` list had at least one value.\n * @param extensions - The list of extensions allowed\n * @returns true if the file has a valid name.\n * @remarks \\@since 3.1.0\n */\nexport type IsValidFileName = (\n  file: File,\n  extensionRegExp: RegExp | undefined,\n  extensions: readonly string[]\n) => boolean;\n\n/**\n *\n * @defaultValue `matcher?.test(file.name) ?? true`\n * @remarks \\@since 3.1.0\n */\nexport const isValidFileName: IsValidFileName = (file, matcher) =>\n  matcher?.test(file.name) ?? true;\n\n/** @remarks \\@since 2.9.0 */\nexport interface FileValidationOptions {\n  /**\n   * If the number of files should be limited, set this value to a number\n   * greater than `0`.\n   *\n   * Note: This still allows \"infinite\" files when set to `0` since the\n   * `<input>` element should normally be set to `disabled` if files should not\n   * be able to be uploaded.\n   *\n   * @defaultValue `-1`\n   */\n  maxFiles?: number;\n\n  /**\n   * An optional minimum file size to enforce for each file. This will only be\n   * used when it is greater than `0`.\n   *\n   * @defaultValue `-1`\n   */\n  minFileSize?: number;\n\n  /**\n   * An optional maximum file size to enforce for each file. This will only be\n   * used when it is greater than `0`.\n   *\n   * @defaultValue `-1`\n   */\n  maxFileSize?: number;\n\n  /**\n   * An optional list of extensions to enforce when uploading files.\n   *\n   * Note: The extensions and file names will be compared ignoring case.\n   *\n   * @example\n   * Only Allow Images\n   * ```ts\n   * const extensions = [\"png\", \"jpeg\", \"jpg\", \"gif\"];\n   * ```\n   */\n  extensions?: readonly string[];\n\n  /** {@inheritDoc IsValidFileName} */\n  isValidFileName?: IsValidFileName;\n\n  /**\n   * An optional total file size to enforce when the {@link maxFiles} option is\n   * not set to `1`.\n   *\n   * @defaultValue `-1`\n   */\n  totalFileSize?: number;\n}\n\n/** @remarks \\@since 2.9.0 */\nexport interface FilesValidationOptions\n  extends Required<FileValidationOptions> {\n  /**\n   * The total number of bytes in the {@link FileUploadHookReturnValue.stats}\n   * list. This is really just:\n   *\n   * ```ts\n   * const totalBytes = stats.reduce((total, stat) => total + stat.file.size, 0);\n   * ```\n   */\n  totalBytes: number;\n\n  /**\n   * The total number of files in the {@link FileUploadHookReturnValue.stats}.\n   */\n  totalFiles: number;\n}\n\n/** @remarks \\@since 2.9.0 */\nexport interface ValidatedFilesResult<CustomError> {\n  /**\n   * A filtered list of files that have been validated and can be queued for the\n   * upload process.\n   */\n  pending: readonly File[];\n\n  /**\n   * A list of {@link FileValidationError} that occurred during the validation\n   * step.\n   *\n   * Note: If an error has occurred, the file **should not** be added to the\n   * {@link pending} list of files.\n   */\n  errors: readonly FileValidationError<CustomError>[];\n}\n\n/**\n * This function will be called whenever a file has been uploaded by the user\n * either through an `<input type=\"file\">` or drag and drop behavior.\n *\n * @example\n * Simple Example\n * ```ts\n * const validateFiles: FilesValidator = (files, options) => {\n *   const invalid: File[] = [];\n *   const pending: File[] = [];\n *   for (const file of files) {\n *     if (!/\\.(jpe?g|svg|png)$/i.test(name)) {\n *       invalid.push(file);\n *     } else {\n *       pending.push(file);\n *     }\n *   }\n *\n *   const errors: FileValidationError[] = [];\n *   if (invalid.length) {\n *     errors.push(new GenericFileError(invalid))\n *   }\n *\n *   return { pending, errors };\n * };\n * ```\n *\n * @typeparam E - An optional custom file validation error.\n * @param files - The list of files to check\n * @param options - The {@link FilesValidationOptions}\n * @returns the {@link ValidatedFilesResult}\n * @see {@link validateFiles} for the default implementation\n * @remarks \\@since 2.9.0\n */\nexport type FilesValidator<CustomError = never> = (\n  files: readonly File[],\n  options: FilesValidationOptions\n) => ValidatedFilesResult<CustomError>;\n\n/**\n * A pretty decent default implementation for validating files with the\n * {@link useFileUpload} that ensures the {@link FilesValidationOptions} are\n * enforced before allowing a file to be uploaded.\n *\n * @typeparam E - An optional custom file validation error.\n * @param files - The list of files to check\n * @param options - The {@link FilesValidationOptions}\n * @returns the {@link ValidatedFilesResult}\n * @remarks \\@since 2.9.0\n */\nexport function validateFiles<CustomError>(\n  files: readonly File[],\n  {\n    maxFiles,\n    extensions,\n    minFileSize,\n    maxFileSize,\n    totalBytes,\n    totalFiles,\n    totalFileSize,\n    isValidFileName,\n  }: FilesValidationOptions\n): ValidatedFilesResult<CustomError> {\n  const errors: FileValidationError<CustomError>[] = [];\n  const pending: File[] = [];\n  const extraFiles: File[] = [];\n  const extensionRegExp =\n    extensions.length > 0\n      ? new RegExp(`\\\\.(${extensions.join(\"|\")})$`, \"i\")\n      : undefined;\n\n  let maxFilesReached = maxFiles > 0 && totalFiles >= maxFiles;\n  let remainingBytes = totalFileSize - totalBytes;\n  const extensionErrors: File[] = [];\n  const minErrors: File[] = [];\n  const maxErrors: File[] = [];\n  const totalSizeErrors: File[] = [];\n  for (let i = 0; i < files.length; i += 1) {\n    const file = files[i];\n\n    let valid = true;\n    const { size } = file;\n    if (!isValidFileName(file, extensionRegExp, extensions)) {\n      valid = false;\n      extensionErrors.push(file);\n    }\n\n    if (minFileSize > 0 && size < minFileSize) {\n      valid = false;\n      minErrors.push(file);\n    }\n\n    if (maxFileSize > 0 && size > maxFileSize) {\n      valid = false;\n      maxErrors.push(file);\n    } else if (totalFileSize > 0 && remainingBytes - file.size < 0) {\n      // don't want both errors displaying\n      valid = false;\n      totalSizeErrors.push(file);\n    }\n\n    if (maxFilesReached && valid) {\n      extraFiles.push(file);\n    } else if (!maxFilesReached && valid) {\n      pending.push(file);\n      remainingBytes -= file.size;\n      maxFilesReached =\n        maxFilesReached ||\n        (maxFiles > 0 && totalFiles + pending.length >= maxFiles);\n    }\n  }\n\n  if (extensionErrors.length) {\n    errors.push(new FileExtensionError(extensionErrors, extensions));\n  }\n\n  if (minErrors.length) {\n    errors.push(new FileSizeError(minErrors, \"min\", minFileSize));\n  }\n\n  if (maxErrors.length) {\n    errors.push(new FileSizeError(maxErrors, \"max\", maxFileSize));\n  }\n\n  if (totalSizeErrors.length) {\n    errors.push(new FileSizeError(totalSizeErrors, \"total\", totalFileSize));\n  }\n\n  if (extraFiles.length) {\n    errors.push(new TooManyFilesError(extraFiles, maxFiles));\n  }\n\n  return { pending, errors };\n}\n\n/**\n * This will first check if the mime-type of the file starts with `text/` and\n * fallback to checking a few file names or extensions that should be considered\n * text.\n *\n * This function is not guaranteed to be 100% correct and is only useful if\n * trying to generate a preview of files uploaded to the browser.\n *\n * @param file - The file to check\n * @returns `true` if the file should be considered as a text-content file.\n * @remarks \\@since 2.9.0\n */\nexport function isTextFile(file: File): boolean {\n  return /\\.((j|t)sx?|json|lock|hbs|ya?ml|log|txt|md)$/i.test(file.name);\n}\n\n/**\n * This will first check if the mime-type of the file starts with `text\\/` and\n * fallback to checking a few file names or extensions that should be considered\n * text.\n *\n * This function is not guaranteed to be 100% correct and is only useful if\n * trying to generate a preview of files uploaded to the browser.\n *\n * @param file - The file to check\n * @returns `true` if the file should be considered as a text content file.\n * @remarks \\@since 2.9.0\n */\nexport function isImageFile(file: File): boolean {\n  return /\\.(a?png|avif|svg|tiff|gifv?|jpe?g)/i.test(file.name);\n}\n\n/**\n * This will first check if the mime-type of the file starts with `audio/` and\n * fallback to checking a few file names or extensions that should be considered\n * audio.\n *\n * This function is not guaranteed to be 100% correct and is only useful if\n * trying to generate a preview of files uploaded to the browser.\n *\n * @param file - The file to check\n * @returns `true` if the file should be considered as a audio content file.\n * @remarks \\@since 2.9.0\n */\nexport function isAudioFile(file: File): boolean {\n  return /\\.(mp3|wav|ogg|m4p|flac)$/i.test(file.name);\n}\n\n/**\n * This will first check if the mime-type of the file starts with `video/` and\n * fallback to checking a few file names or extensions that should be considered\n * video.\n *\n * This function is not guaranteed to be 100% correct and is only useful if\n * trying to generate a preview of files uploaded to the browser.\n *\n * @param file - The file to check\n * @returns `true` if the file should be considered as a video content file.\n * @remarks \\@since 2.9.0\n */\nexport function isVideoFile(file: File): boolean {\n  return /\\.(mkv|mpe?g|mov|avi|flv|webm|mp4)$/i.test(file.name);\n}\n\n/**\n * This function is not guaranteed to be 100% correct and is only useful if\n * trying to generate a preview of files uploaded to the browser.\n *\n * @param file - The file to check\n * @returns `true` if the file matches an image, audio, or video file.\n * @remarks \\@since 2.9.0\n */\nexport function isMediaFile(file: File): boolean {\n  return isImageFile(file) || isAudioFile(file) || isVideoFile(file);\n}\n\n/**\n * One of the function names from a `FileReader` to upload a file to the\n * client.\n *\n * Note: If this file does not need to be previewed in the browser and will\n * immediately be uploaded to a server, use `readAsArrayBuffer`.\n *\n * @remarks \\@since 2.9.0\n */\nexport type FileReaderParser =\n  | \"readAsText\"\n  | \"readAsDataURL\"\n  | \"readAsBinaryString\"\n  | \"readAsArrayBuffer\";\n\n/**\n * A function that should return one of the {@link FileReaderParser} functions\n * to start uploading a file to the browser.\n *\n * @example\n * The Default File Upload Parser\n * ```ts\n * export const getFileParser: GetFileParser = (file) => {\n *   if (isMediaFile(file)) {\n *     return \"readAsDataURL\";\n *   }\n *\n *   if (isTextFile(file)) {\n *     return \"readAsText\";\n *   }\n *\n *   return \"readAsArrayBuffer\";\n * };\n * ```\n *\n * @param file - The file to get a parser for\n * @returns the {@link FileReaderParser} string.\n * @remarks \\@since 2.9.0\n */\nexport type GetFileParser = (file: File) => FileReaderParser;\n\n/**\n * This function will attempt to read:\n * - media (image, audio, and video) files as a data url so they can be\n *   previewed in `<img>`, `<audio>`, and `<video>` tags\n * - text files as plain text\n * - everything else as an `ArrayBuffer` which can be manually converted into a\n *   data url if needed with `URL.createObjectURL`\n *\n * @remarks \\@since 2.9.0\n */\nexport const getFileParser: GetFileParser = (file) => {\n  if (isMediaFile(file)) {\n    return \"readAsDataURL\";\n  }\n\n  if (isTextFile(file)) {\n    return \"readAsText\";\n  }\n\n  return \"readAsArrayBuffer\";\n};\n\n/** @remarks \\@since 2.9.0 */\nexport interface SplitFileUploads {\n  readonly pending: readonly ProcessingFileUploadStats[];\n  readonly uploading: readonly ProcessingFileUploadStats[];\n  readonly complete: readonly CompletedFileUploadStats[];\n}\n\n/**\n * This util will split all the current upload stats by status.\n *\n * @param stats - The {@link FileUploadStats} list generally returned by the\n * {@link useFileUpload} hook.\n * @returns the {@link SplitFileUploads}.\n * @remarks \\@since 2.9.0\n */\nexport function getSplitFileUploads(\n  stats: readonly FileUploadStats[]\n): SplitFileUploads {\n  const pending: ProcessingFileUploadStats[] = [];\n  const uploading: ProcessingFileUploadStats[] = [];\n  const complete: CompletedFileUploadStats[] = [];\n  stats.forEach((stat) => {\n    if (stat.status === \"pending\") {\n      pending.push(stat);\n    } else if (stat.status === \"uploading\") {\n      uploading.push(stat);\n    } else if (stat.status === \"complete\") {\n      complete.push(stat);\n    } else {\n      /* istanbul ignore next */\n      throw new Error(\"Invalid upload stat\");\n    }\n  });\n\n  return { pending, uploading, complete };\n}\n"],"names":["nanoid","FileAccessError","Error","constructor","message","key","name","GenericFileError","files","reason","TooManyFilesError","limit","FileSizeError","type","FileExtensionError","extensions","isGenericFileError","error","isFileAccessError","isTooManyFilesError","isFileSizeError","isFileExtensionError","isValidFileName","file","matcher","test","validateFiles","maxFiles","minFileSize","maxFileSize","totalBytes","totalFiles","totalFileSize","errors","pending","extraFiles","extensionRegExp","length","RegExp","join","undefined","maxFilesReached","remainingBytes","extensionErrors","minErrors","maxErrors","totalSizeErrors","i","valid","size","push","isTextFile","isImageFile","isAudioFile","isVideoFile","isMediaFile","getFileParser","getSplitFileUploads","stats","uploading","complete","forEach","stat","status"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"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"}
+{"version":3,"sources":["../../src/form/fileUtils.ts"],"sourcesContent":["import { nanoid } from \"nanoid\";\nimport { type ChangeEventHandler, type DragEventHandler } from \"react\";\n\n/** @since 2.9.0 */\nexport interface BaseFileUploadStats {\n  /**\n   * A unique key associated with each upload generated by `nanoid`.\n   */\n  key: string;\n\n  /**\n   * The file instance that is being uploaded.\n   */\n  file: File;\n\n  /**\n   * The current upload progress as a percentage from 0 - 100 percent.\n   */\n  progress: number;\n}\n\n/** @since 2.9.0 */\nexport interface ProcessingFileUploadStats extends BaseFileUploadStats {\n  status: \"pending\" | \"uploading\";\n}\n\n/** @since 2.9.0 */\nexport type FileReaderResult = FileReader[\"result\"];\n\n/** @since 2.9.0 */\nexport interface CompletedFileUploadStats extends BaseFileUploadStats {\n  status: \"complete\";\n\n  /**\n   * The result after a `FileReader` has read a file completely.\n   *\n   * Note: This _should_ be an `ArrayBuffer` if the next step is to upload to a\n   * server.\n   *\n   * @see {@link FileReaderParser}\n   * @see {@link getFileParser}\n   * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileReader | FileReader}\n   */\n  result: FileReaderResult;\n}\n\n/** @since 2.9.0 */\nexport type FileUploadStats =\n  | ProcessingFileUploadStats\n  | CompletedFileUploadStats;\n\n/** @since 2.9.0 */\nexport type FileUploadStatus = FileUploadStats[\"status\"];\n\n/** @since 2.9.0 */\nexport interface FileUploadHandlers<E extends HTMLElement> {\n  onDrop?: DragEventHandler<E>;\n  onChange?: ChangeEventHandler<HTMLInputElement>;\n}\n\n/**\n * An error that will be created if a user tries dragging and dropping files\n * from a shared directory that they do not have access to. This error will not\n * occur much.\n *\n * @since 2.9.0\n */\nexport class FileAccessError extends Error {\n  /**\n   * A unique key generated by `nanoid` that can be used as a `React` key\n   */\n  public key: string;\n\n  /**\n   *\n   * @param message - An optional message for the error.\n   */\n  constructor(message?: string) {\n    super(message);\n    this.key = nanoid();\n    this.name = \"FileAccessError\";\n  }\n}\n\n/**\n * An error that just requires a `File` to be passed as the first argument.\n *\n * @since 2.9.0\n */\nexport class GenericFileError extends Error {\n  /**\n   * A unique key generated by `nanoid` that can be used as a `React` key\n   */\n  public key: string;\n\n  /**\n   *\n   * @param files - A list of files that caused the error.\n   * @param reason - An optional reason for the error\n   */\n  constructor(\n    public files: readonly File[],\n    public reason?: string\n  ) {\n    super(\"Invalid files\");\n    this.key = nanoid();\n    this.name = \"GenericFileError\";\n  }\n}\n\n/**\n * An error that is created during the upload process if the number of files\n * exceeds the {@link FileUploadOptions.maxFiles} amount.\n *\n * @since 2.9.0\n */\nexport class TooManyFilesError extends GenericFileError {\n  /**\n   *\n   * @param files - The list of files that could not be uploaded due to the file\n   * limit defined.\n   * @param limit - The max limit of files allowed.\n   */\n  constructor(\n    files: readonly File[],\n    public limit: number\n  ) {\n    super(files, \"file limit\");\n    this.name = \"TooManyFilesError\";\n  }\n}\n\n/**\n * An error that will be created if a user tries to upload a file that\n * is either:\n * - less than the {@link FileValidationOptions.minFileSize}\n * - greater than the {@link FileValidationOptions.maxFileSize}\n * - including the file would be greater than the {@link FileValidationOptions.totalFileSize}\n *\n * @since 2.9.0\n */\nexport class FileSizeError extends GenericFileError {\n  /**\n   *\n   * @param files - The list of files that have the file size error\n   * @param type - The file size error type\n   * @param limit - The number of bytes allowed based on the type\n   */\n  constructor(\n    files: readonly File[],\n    public type: \"min\" | \"max\" | \"total\",\n    public limit: number\n  ) {\n    super(files, \"file size\");\n    this.name = \"FileSizeError\";\n  }\n}\n\n/**\n * An error that will be created if a user tries to upload a file that does not\n * end with one of the {@link FileValidationOptions.extensions}.\n *\n * @since 2.9.0\n */\nexport class FileExtensionError extends GenericFileError {\n  /**\n   *\n   * @param files - The file that caused the error\n   * @param extensions - The allowed list of file extensions\n   */\n  constructor(\n    files: readonly File[],\n    public extensions: readonly string[]\n  ) {\n    super(files, \"extension\");\n    this.name = \"FileExtensionError\";\n  }\n}\n\n/**\n * Mostly an internal type that is used to allow custom validation errors\n *\n * @since 2.9.0\n */\nexport type FileValidationError<E = GenericFileError> =\n  | FileAccessError\n  | TooManyFilesError\n  | FileSizeError\n  | FileExtensionError\n  | E;\n\n/**\n * A simple type-guard that can be used to check if the\n * {@link FileValidationError} is the {@link GenericFileError} which can be\n * useful when displaying the errors to the user.\n *\n * @param error - The error to check\n * @returns true if the error is a {@link FileAccessError}\n */\nexport function isGenericFileError<CustomError extends {}>(\n  error: FileValidationError<CustomError>\n): error is GenericFileError {\n  return \"name\" in error && error.name === \"GenericFileError\";\n}\n\n/**\n * A simple type-guard that can be used to check if the\n * {@link FileValidationError} is the {@link FileAccessError} which can be\n * useful when displaying the errors to the user.\n *\n * @param error - The error to check\n * @returns true if the error is a {@link FileAccessError}\n */\nexport function isFileAccessError<CustomError extends {}>(\n  error: FileValidationError<CustomError>\n): error is FileAccessError {\n  return \"name\" in error && error.name === \"FileAccessError\";\n}\n\n/**\n * A simple type-guard that can be used to check if the\n * {@link FileValidationError} is the {@link TooManyFilesError} which can be\n * useful when displaying the errors to the user.\n *\n * @param error - The error to check\n * @returns true if the error is a {@link TooManyFilesError}\n */\nexport function isTooManyFilesError<CustomError extends {}>(\n  error: FileValidationError<CustomError>\n): error is TooManyFilesError {\n  return \"name\" in error && error.name === \"TooManyFilesError\";\n}\n\n/**\n * A simple type-guard that can be used to check if the\n * {@link FileValidationError} is the {@link FileSizeError} which can be\n * useful when displaying the errors to the user.\n *\n * @param error - The error to check\n * @returns true if the error is a {@link FileSizeError}\n */\nexport function isFileSizeError<CustomError extends {}>(\n  error: FileValidationError<CustomError>\n): error is FileSizeError {\n  return \"name\" in error && error.name === \"FileSizeError\";\n}\n\n/**\n * A simple type-guard that can be used to check if the\n * {@link FileValidationError} is the {@link FileExtensionError} which can be\n * useful when displaying the errors to the user.\n *\n * @param error - The error to check\n * @returns true if the error is a {@link FileExtensionError}\n */\nexport function isFileExtensionError<CustomError extends {}>(\n  error: FileValidationError<CustomError>\n): error is FileExtensionError {\n  return \"name\" in error && error.name === \"FileExtensionError\";\n}\n\n/**\n * This function is used to determine if a file should be added to the\n * {@link FileExtensionError}. The default implementation should work for most\n * use cases except when files that do not have extensions can be uploaded. i.e.\n * LICENSE files.\n *\n * @param file - The file being checked\n * @param extensionRegExp - A regex that will only be defined if the\n * `extensions` list had at least one value.\n * @param extensions - The list of extensions allowed\n * @returns true if the file has a valid name.\n * @since 3.1.0\n */\nexport type IsValidFileName = (\n  file: File,\n  extensionRegExp: RegExp | undefined,\n  extensions: readonly string[]\n) => boolean;\n\n/**\n *\n * @defaultValue `matcher?.test(file.name) ?? true`\n * @since 3.1.0\n */\nexport const isValidFileName: IsValidFileName = (file, matcher) =>\n  matcher?.test(file.name) ?? true;\n\n/** @since 2.9.0 */\nexport interface FileValidationOptions {\n  /**\n   * If the number of files should be limited, set this value to a number\n   * greater than `0`.\n   *\n   * Note: This still allows \"infinite\" files when set to `0` since the\n   * `<input>` element should normally be set to `disabled` if files should not\n   * be able to be uploaded.\n   *\n   * @defaultValue `-1`\n   */\n  maxFiles?: number;\n\n  /**\n   * An optional minimum file size to enforce for each file. This will only be\n   * used when it is greater than `0`.\n   *\n   * @defaultValue `-1`\n   */\n  minFileSize?: number;\n\n  /**\n   * An optional maximum file size to enforce for each file. This will only be\n   * used when it is greater than `0`.\n   *\n   * @defaultValue `-1`\n   */\n  maxFileSize?: number;\n\n  /**\n   * An optional list of extensions to enforce when uploading files.\n   *\n   * Note: The extensions and file names will be compared ignoring case.\n   *\n   * @example Only Allow Images\n   * ```ts\n   * const extensions = [\"png\", \"jpeg\", \"jpg\", \"gif\"];\n   * ```\n   */\n  extensions?: readonly string[];\n\n  /** {@inheritDoc IsValidFileName} */\n  isValidFileName?: IsValidFileName;\n\n  /**\n   * An optional total file size to enforce when the {@link maxFiles} option is\n   * not set to `1`.\n   *\n   * @defaultValue `-1`\n   */\n  totalFileSize?: number;\n}\n\n/** @since 2.9.0 */\nexport interface FilesValidationOptions\n  extends Required<FileValidationOptions> {\n  /**\n   * The total number of bytes in the {@link FileUploadHookReturnValue.stats}\n   * list. This is really just:\n   *\n   * ```ts\n   * const totalBytes = stats.reduce((total, stat) => total + stat.file.size, 0);\n   * ```\n   */\n  totalBytes: number;\n\n  /**\n   * The total number of files in the {@link FileUploadHookReturnValue.stats}.\n   */\n  totalFiles: number;\n}\n\n/** @since 2.9.0 */\nexport interface ValidatedFilesResult<CustomError> {\n  /**\n   * A filtered list of files that have been validated and can be queued for the\n   * upload process.\n   */\n  pending: readonly File[];\n\n  /**\n   * A list of {@link FileValidationError} that occurred during the validation\n   * step.\n   *\n   * Note: If an error has occurred, the file **should not** be added to the\n   * {@link pending} list of files.\n   */\n  errors: readonly FileValidationError<CustomError>[];\n}\n\n/**\n * This function will be called whenever a file has been uploaded by the user\n * either through an `<input type=\"file\">` or drag and drop behavior.\n *\n * @example Simple Example\n * ```ts\n * const validateFiles: FilesValidator = (files, options) => {\n *   const invalid: File[] = [];\n *   const pending: File[] = [];\n *   for (const file of files) {\n *     if (!/\\.(jpe?g|svg|png)$/i.test(name)) {\n *       invalid.push(file);\n *     } else {\n *       pending.push(file);\n *     }\n *   }\n *\n *   const errors: FileValidationError[] = [];\n *   if (invalid.length) {\n *     errors.push(new GenericFileError(invalid))\n *   }\n *\n *   return { pending, errors };\n * };\n * ```\n *\n * @typeparam E - An optional custom file validation error.\n * @param files - The list of files to check\n * @param options - The {@link FilesValidationOptions}\n * @returns the {@link ValidatedFilesResult}\n * @see {@link validateFiles} for the default implementation\n * @since 2.9.0\n */\nexport type FilesValidator<CustomError = never> = (\n  files: readonly File[],\n  options: FilesValidationOptions\n) => ValidatedFilesResult<CustomError>;\n\n/**\n * A pretty decent default implementation for validating files with the\n * {@link useFileUpload} that ensures the {@link FilesValidationOptions} are\n * enforced before allowing a file to be uploaded.\n *\n * @typeparam E - An optional custom file validation error.\n * @param files - The list of files to check\n * @param options - The {@link FilesValidationOptions}\n * @returns the {@link ValidatedFilesResult}\n * @since 2.9.0\n */\nexport function validateFiles<CustomError>(\n  files: readonly File[],\n  {\n    maxFiles,\n    extensions,\n    minFileSize,\n    maxFileSize,\n    totalBytes,\n    totalFiles,\n    totalFileSize,\n    isValidFileName,\n  }: FilesValidationOptions\n): ValidatedFilesResult<CustomError> {\n  const errors: FileValidationError<CustomError>[] = [];\n  const pending: File[] = [];\n  const extraFiles: File[] = [];\n  const extensionRegExp =\n    extensions.length > 0\n      ? new RegExp(`\\\\.(${extensions.join(\"|\")})$`, \"i\")\n      : undefined;\n\n  let maxFilesReached = maxFiles > 0 && totalFiles >= maxFiles;\n  let remainingBytes = totalFileSize - totalBytes;\n  const extensionErrors: File[] = [];\n  const minErrors: File[] = [];\n  const maxErrors: File[] = [];\n  const totalSizeErrors: File[] = [];\n  for (let i = 0; i < files.length; i += 1) {\n    const file = files[i];\n\n    let valid = true;\n    const { size } = file;\n    if (!isValidFileName(file, extensionRegExp, extensions)) {\n      valid = false;\n      extensionErrors.push(file);\n    }\n\n    if (minFileSize > 0 && size < minFileSize) {\n      valid = false;\n      minErrors.push(file);\n    }\n\n    if (maxFileSize > 0 && size > maxFileSize) {\n      valid = false;\n      maxErrors.push(file);\n    } else if (totalFileSize > 0 && remainingBytes - file.size < 0) {\n      // don't want both errors displaying\n      valid = false;\n      totalSizeErrors.push(file);\n    }\n\n    if (maxFilesReached && valid) {\n      extraFiles.push(file);\n    } else if (!maxFilesReached && valid) {\n      pending.push(file);\n      remainingBytes -= file.size;\n      maxFilesReached =\n        maxFilesReached ||\n        (maxFiles > 0 && totalFiles + pending.length >= maxFiles);\n    }\n  }\n\n  if (extensionErrors.length) {\n    errors.push(new FileExtensionError(extensionErrors, extensions));\n  }\n\n  if (minErrors.length) {\n    errors.push(new FileSizeError(minErrors, \"min\", minFileSize));\n  }\n\n  if (maxErrors.length) {\n    errors.push(new FileSizeError(maxErrors, \"max\", maxFileSize));\n  }\n\n  if (totalSizeErrors.length) {\n    errors.push(new FileSizeError(totalSizeErrors, \"total\", totalFileSize));\n  }\n\n  if (extraFiles.length) {\n    errors.push(new TooManyFilesError(extraFiles, maxFiles));\n  }\n\n  return { pending, errors };\n}\n\n/**\n * This will first check if the mime-type of the file starts with `text/` and\n * fallback to checking a few file names or extensions that should be considered\n * text.\n *\n * This function is not guaranteed to be 100% correct and is only useful if\n * trying to generate a preview of files uploaded to the browser.\n *\n * @param file - The file to check\n * @returns `true` if the file should be considered as a text-content file.\n * @since 2.9.0\n */\nexport function isTextFile(file: File): boolean {\n  return /\\.((j|t)sx?|json|lock|hbs|ya?ml|log|txt|md)$/i.test(file.name);\n}\n\n/**\n * This will first check if the mime-type of the file starts with `text\\/` and\n * fallback to checking a few file names or extensions that should be considered\n * text.\n *\n * This function is not guaranteed to be 100% correct and is only useful if\n * trying to generate a preview of files uploaded to the browser.\n *\n * @param file - The file to check\n * @returns `true` if the file should be considered as a text content file.\n * @since 2.9.0\n */\nexport function isImageFile(file: File): boolean {\n  return /\\.(a?png|avif|svg|tiff|gifv?|jpe?g)/i.test(file.name);\n}\n\n/**\n * This will first check if the mime-type of the file starts with `audio/` and\n * fallback to checking a few file names or extensions that should be considered\n * audio.\n *\n * This function is not guaranteed to be 100% correct and is only useful if\n * trying to generate a preview of files uploaded to the browser.\n *\n * @param file - The file to check\n * @returns `true` if the file should be considered as a audio content file.\n * @since 2.9.0\n */\nexport function isAudioFile(file: File): boolean {\n  return /\\.(mp3|wav|ogg|m4p|flac)$/i.test(file.name);\n}\n\n/**\n * This will first check if the mime-type of the file starts with `video/` and\n * fallback to checking a few file names or extensions that should be considered\n * video.\n *\n * This function is not guaranteed to be 100% correct and is only useful if\n * trying to generate a preview of files uploaded to the browser.\n *\n * @param file - The file to check\n * @returns `true` if the file should be considered as a video content file.\n * @since 2.9.0\n */\nexport function isVideoFile(file: File): boolean {\n  return /\\.(mkv|mpe?g|mov|avi|flv|webm|mp4)$/i.test(file.name);\n}\n\n/**\n * This function is not guaranteed to be 100% correct and is only useful if\n * trying to generate a preview of files uploaded to the browser.\n *\n * @param file - The file to check\n * @returns `true` if the file matches an image, audio, or video file.\n * @since 2.9.0\n */\nexport function isMediaFile(file: File): boolean {\n  return isImageFile(file) || isAudioFile(file) || isVideoFile(file);\n}\n\n/**\n * One of the function names from a `FileReader` to upload a file to the\n * client.\n *\n * Note: If this file does not need to be previewed in the browser and will\n * immediately be uploaded to a server, use `readAsArrayBuffer`.\n *\n * @since 2.9.0\n */\nexport type FileReaderParser =\n  | \"readAsText\"\n  | \"readAsDataURL\"\n  | \"readAsBinaryString\"\n  | \"readAsArrayBuffer\";\n\n/**\n * A function that should return one of the {@link FileReaderParser} functions\n * to start uploading a file to the browser.\n *\n * @example The Default File Upload Parser\n * ```ts\n * export const getFileParser: GetFileParser = (file) => {\n *   if (isMediaFile(file)) {\n *     return \"readAsDataURL\";\n *   }\n *\n *   if (isTextFile(file)) {\n *     return \"readAsText\";\n *   }\n *\n *   return \"readAsArrayBuffer\";\n * };\n * ```\n *\n * @param file - The file to get a parser for\n * @returns the {@link FileReaderParser} string.\n * @since 2.9.0\n */\nexport type GetFileParser = (file: File) => FileReaderParser;\n\n/**\n * This function will attempt to read:\n * - media (image, audio, and video) files as a data url so they can be\n *   previewed in `<img>`, `<audio>`, and `<video>` tags\n * - text files as plain text\n * - everything else as an `ArrayBuffer` which can be manually converted into a\n *   data url if needed with `URL.createObjectURL`\n *\n * @since 2.9.0\n */\nexport const getFileParser: GetFileParser = (file) => {\n  if (isMediaFile(file)) {\n    return \"readAsDataURL\";\n  }\n\n  if (isTextFile(file)) {\n    return \"readAsText\";\n  }\n\n  return \"readAsArrayBuffer\";\n};\n\n/** @since 2.9.0 */\nexport interface SplitFileUploads {\n  readonly pending: readonly ProcessingFileUploadStats[];\n  readonly uploading: readonly ProcessingFileUploadStats[];\n  readonly complete: readonly CompletedFileUploadStats[];\n}\n\n/**\n * This util will split all the current upload stats by status.\n *\n * @param stats - The {@link FileUploadStats} list generally returned by the\n * {@link useFileUpload} hook.\n * @returns the {@link SplitFileUploads}.\n * @since 2.9.0\n */\nexport function getSplitFileUploads(\n  stats: readonly FileUploadStats[]\n): SplitFileUploads {\n  const pending: ProcessingFileUploadStats[] = [];\n  const uploading: ProcessingFileUploadStats[] = [];\n  const complete: CompletedFileUploadStats[] = [];\n  stats.forEach((stat) => {\n    if (stat.status === \"pending\") {\n      pending.push(stat);\n    } else if (stat.status === \"uploading\") {\n      uploading.push(stat);\n    } else if (stat.status === \"complete\") {\n      complete.push(stat);\n    } else {\n      /* istanbul ignore next */\n      throw new Error(\"Invalid upload stat\");\n    }\n  });\n\n  return { pending, uploading, complete };\n}\n"],"names":["nanoid","FileAccessError","Error","constructor","message","key","name","GenericFileError","files","reason","TooManyFilesError","limit","FileSizeError","type","FileExtensionError","extensions","isGenericFileError","error","isFileAccessError","isTooManyFilesError","isFileSizeError","isFileExtensionError","isValidFileName","file","matcher","test","validateFiles","maxFiles","minFileSize","maxFileSize","totalBytes","totalFiles","totalFileSize","errors","pending","extraFiles","extensionRegExp","length","RegExp","join","undefined","maxFilesReached","remainingBytes","extensionErrors","minErrors","maxErrors","totalSizeErrors","i","valid","size","push","isTextFile","isImageFile","isAudioFile","isVideoFile","isMediaFile","getFileParser","getSplitFileUploads","stats","uploading","complete","forEach","stat","status"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"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"}

package/dist/form/formConfig.d.ts

@@ -1,9 +1,9 @@
 import { type FormConfiguration } from "./types.js";
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare const FORM_CONFIG: FormConfiguration;
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare function getFormConfig<N extends keyof FormConfiguration>(name: N, override?: FormConfiguration[N]): FormConfiguration[N];

package/dist/form/formConfig.js

@@ -1,12 +1,12 @@
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export const FORM_CONFIG = {
     theme: "outline",
     underlineDirection: "left",
     uncontrolledToggles: true
 };
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export function getFormConfig(name, override) {
     if (typeof override !== "undefined") {
         return override;

package/dist/form/formConfig.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/form/formConfig.ts"],"sourcesContent":["import { type FormConfiguration } from \"./types.js\";\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport const FORM_CONFIG: FormConfiguration = {\n  theme: \"outline\",\n  underlineDirection: \"left\",\n  uncontrolledToggles: true,\n};\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport function getFormConfig<N extends keyof FormConfiguration>(\n  name: N,\n  override?: FormConfiguration[N]\n): FormConfiguration[N] {\n  if (typeof override !== \"undefined\") {\n    return override;\n  }\n\n  return FORM_CONFIG[name];\n}\n"],"names":["FORM_CONFIG","theme","underlineDirection","uncontrolledToggles","getFormConfig","name","override"],"rangeMappings":";;;;;;;;;;;;;;","mappings":"AAEA;;CAEC,GACD,OAAO,MAAMA,cAAiC;IAC5CC,OAAO;IACPC,oBAAoB;IACpBC,qBAAqB;AACvB,EAAE;AAEF;;CAEC,GACD,OAAO,SAASC,cACdC,IAAO,EACPC,QAA+B;IAE/B,IAAI,OAAOA,aAAa,aAAa;QACnC,OAAOA;IACT;IAEA,OAAON,WAAW,CAACK,KAAK;AAC1B"}
+{"version":3,"sources":["../../src/form/formConfig.ts"],"sourcesContent":["import { type FormConfiguration } from \"./types.js\";\n\n/**\n * @since 6.0.0\n */\nexport const FORM_CONFIG: FormConfiguration = {\n  theme: \"outline\",\n  underlineDirection: \"left\",\n  uncontrolledToggles: true,\n};\n\n/**\n * @since 6.0.0\n */\nexport function getFormConfig<N extends keyof FormConfiguration>(\n  name: N,\n  override?: FormConfiguration[N]\n): FormConfiguration[N] {\n  if (typeof override !== \"undefined\") {\n    return override;\n  }\n\n  return FORM_CONFIG[name];\n}\n"],"names":["FORM_CONFIG","theme","underlineDirection","uncontrolledToggles","getFormConfig","name","override"],"rangeMappings":";;;;;;;;;;;;;;","mappings":"AAEA;;CAEC,GACD,OAAO,MAAMA,cAAiC;IAC5CC,OAAO;IACPC,oBAAoB;IACpBC,qBAAqB;AACvB,EAAE;AAEF;;CAEC,GACD,OAAO,SAASC,cACdC,IAAO,EACPC,QAA+B;IAE/B,IAAI,OAAOA,aAAa,aAAa;QACnC,OAAOA;IACT;IAEA,OAAON,WAAW,CAACK,KAAK;AAC1B"}

package/dist/form/formMessageStyles.d.ts

@@ -1,21 +1,21 @@
 import { type FormMessageClassNameOptions } from "./types.js";
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare function formMessage(options?: FormMessageClassNameOptions): string;
-/** @remarks \@since 6.0.0 */
+/** @since 6.0.0 */
 export interface FormMessageTextClassNameOptions {
     className?: string;
 }
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare function formMessageText(options?: FormMessageTextClassNameOptions): string;
-/** @remarks \@since 6.0.0 */
+/** @since 6.0.0 */
 export interface FormMessageCounterClassNameOptions {
     className?: string;
 }
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare function formMessageCounter(options?: FormMessageCounterClassNameOptions): string;

package/dist/form/formMessageStyles.js

@@ -3,7 +3,7 @@ import { cssUtils } from "../cssUtils.js";
 import { bem } from "../utils/bem.js";
 const styles = bem("rmd-form-message");
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export function formMessage(options = {}) {
     const { className, error = false, theme = "none" } = options;
     return cnb(styles({
@@ -13,13 +13,13 @@ const styles = bem("rmd-form-message");
     }), className);
 }
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export function formMessageText(options = {}) {
     const { className } = options;
     return cnb(styles("message"), className);
 }
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export function formMessageCounter(options = {}) {
     const { className } = options;
     return cnb(styles("counter"), className);

package/dist/form/formMessageStyles.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/form/formMessageStyles.ts"],"sourcesContent":["import { cnb } from \"cnbuilder\";\nimport { cssUtils } from \"../cssUtils.js\";\nimport { bem } from \"../utils/bem.js\";\nimport { type FormMessageClassNameOptions } from \"./types.js\";\n\nconst styles = bem(\"rmd-form-message\");\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport function formMessage(options: FormMessageClassNameOptions = {}): string {\n  const { className, error = false, theme = \"none\" } = options;\n\n  return cnb(\n    styles({ [theme]: theme !== \"none\" }),\n    cssUtils({ textColor: error ? \"error\" : \"text-secondary\" }),\n    className\n  );\n}\n\n/** @remarks \\@since 6.0.0 */\nexport interface FormMessageTextClassNameOptions {\n  className?: string;\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport function formMessageText(\n  options: FormMessageTextClassNameOptions = {}\n): string {\n  const { className } = options;\n\n  return cnb(styles(\"message\"), className);\n}\n\n/** @remarks \\@since 6.0.0 */\nexport interface FormMessageCounterClassNameOptions {\n  className?: string;\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport function formMessageCounter(\n  options: FormMessageCounterClassNameOptions = {}\n): string {\n  const { className } = options;\n\n  return cnb(styles(\"counter\"), className);\n}\n"],"names":["cnb","cssUtils","bem","styles","formMessage","options","className","error","theme","textColor","formMessageText","formMessageCounter"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA,SAASA,GAAG,QAAQ,YAAY;AAChC,SAASC,QAAQ,QAAQ,iBAAiB;AAC1C,SAASC,GAAG,QAAQ,kBAAkB;AAGtC,MAAMC,SAASD,IAAI;AAEnB;;CAEC,GACD,OAAO,SAASE,YAAYC,UAAuC,CAAC,CAAC;IACnE,MAAM,EAAEC,SAAS,EAAEC,QAAQ,KAAK,EAAEC,QAAQ,MAAM,EAAE,GAAGH;IAErD,OAAOL,IACLG,OAAO;QAAE,CAACK,MAAM,EAAEA,UAAU;IAAO,IACnCP,SAAS;QAAEQ,WAAWF,QAAQ,UAAU;IAAiB,IACzDD;AAEJ;AAOA;;CAEC,GACD,OAAO,SAASI,gBACdL,UAA2C,CAAC,CAAC;IAE7C,MAAM,EAAEC,SAAS,EAAE,GAAGD;IAEtB,OAAOL,IAAIG,OAAO,YAAYG;AAChC;AAOA;;CAEC,GACD,OAAO,SAASK,mBACdN,UAA8C,CAAC,CAAC;IAEhD,MAAM,EAAEC,SAAS,EAAE,GAAGD;IAEtB,OAAOL,IAAIG,OAAO,YAAYG;AAChC"}
+{"version":3,"sources":["../../src/form/formMessageStyles.ts"],"sourcesContent":["import { cnb } from \"cnbuilder\";\nimport { cssUtils } from \"../cssUtils.js\";\nimport { bem } from \"../utils/bem.js\";\nimport { type FormMessageClassNameOptions } from \"./types.js\";\n\nconst styles = bem(\"rmd-form-message\");\n\n/**\n * @since 6.0.0\n */\nexport function formMessage(options: FormMessageClassNameOptions = {}): string {\n  const { className, error = false, theme = \"none\" } = options;\n\n  return cnb(\n    styles({ [theme]: theme !== \"none\" }),\n    cssUtils({ textColor: error ? \"error\" : \"text-secondary\" }),\n    className\n  );\n}\n\n/** @since 6.0.0 */\nexport interface FormMessageTextClassNameOptions {\n  className?: string;\n}\n\n/**\n * @since 6.0.0\n */\nexport function formMessageText(\n  options: FormMessageTextClassNameOptions = {}\n): string {\n  const { className } = options;\n\n  return cnb(styles(\"message\"), className);\n}\n\n/** @since 6.0.0 */\nexport interface FormMessageCounterClassNameOptions {\n  className?: string;\n}\n\n/**\n * @since 6.0.0\n */\nexport function formMessageCounter(\n  options: FormMessageCounterClassNameOptions = {}\n): string {\n  const { className } = options;\n\n  return cnb(styles(\"counter\"), className);\n}\n"],"names":["cnb","cssUtils","bem","styles","formMessage","options","className","error","theme","textColor","formMessageText","formMessageCounter"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA,SAASA,GAAG,QAAQ,YAAY;AAChC,SAASC,QAAQ,QAAQ,iBAAiB;AAC1C,SAASC,GAAG,QAAQ,kBAAkB;AAGtC,MAAMC,SAASD,IAAI;AAEnB;;CAEC,GACD,OAAO,SAASE,YAAYC,UAAuC,CAAC,CAAC;IACnE,MAAM,EAAEC,SAAS,EAAEC,QAAQ,KAAK,EAAEC,QAAQ,MAAM,EAAE,GAAGH;IAErD,OAAOL,IACLG,OAAO;QAAE,CAACK,MAAM,EAAEA,UAAU;IAAO,IACnCP,SAAS;QAAEQ,WAAWF,QAAQ,UAAU;IAAiB,IACzDD;AAEJ;AAOA;;CAEC,GACD,OAAO,SAASI,gBACdL,UAA2C,CAAC,CAAC;IAE7C,MAAM,EAAEC,SAAS,EAAE,GAAGD;IAEtB,OAAOL,IAAIG,OAAO,YAAYG;AAChC;AAOA;;CAEC,GACD,OAAO,SAASK,mBACdN,UAA8C,CAAC,CAAC;IAEhD,MAAM,EAAEC,SAAS,EAAE,GAAGD;IAEtB,OAAOL,IAAIG,OAAO,YAAYG;AAChC"}

package/dist/form/inputToggleStyles.d.ts

@@ -10,10 +10,10 @@ import { type FormComponentStates } from "./types.js";
  * When this is set to `"auto"`, the size will be determined by the current
  * `font-size` of the `Label` element.
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export type InputToggleSize = "auto" | "small" | "dense" | "normal" | "large";
-/** @remarks \@since 6.0.0 */
+/** @since 6.0.0 */
 export interface InputToggleClassNameOptions extends Omit<FormComponentStates, "readOnly"> {
     className?: string;
     type: "checkbox" | "radio";
@@ -31,6 +31,6 @@ export interface InputToggleClassNameOptions extends Omit<FormComponentStates, "
     uncontrolled?: boolean;
 }
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare function inputToggle(options: InputToggleClassNameOptions): string;

package/dist/form/inputToggleStyles.js

@@ -3,7 +3,7 @@ import { cssUtils } from "../cssUtils.js";
 import { bem } from "../utils/bem.js";
 const styles = bem("rmd-input-toggle");
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export function inputToggle(options) {
     const { className, em = true, type, size = "auto", error, active = false, disabled = false, uncontrolled } = options;
     return cnb(`rmd-${type}`, styles({