@react-md/core 1.0.0-next.0

package/dist/form/fileUtils.js

@@ -0,0 +1,351 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+import { nanoid } from "nanoid";
+/**
+ * An error that will be created if a user tries dragging and dropping files
+ * from a shared directory that they do not have access to. This error will not
+ * occur much.
+ *
+ * @remarks \@since 2.9.0
+ */ export class FileAccessError extends Error {
+    /**
+   *
+   * @param message - An optional message for the error.
+   */ constructor(message){
+        super(message);
+        /**
+   * A unique key generated by `nanoid` that can be used as a `React` key
+   */ _define_property(this, "key", void 0);
+        this.key = nanoid();
+        this.name = "FileAccessError";
+    }
+}
+/**
+ * An error that just requires a `File` to be passed as the first argument.
+ *
+ * @remarks \@since 2.9.0
+ */ export class GenericFileError extends Error {
+    /**
+   *
+   * @param files - A list of files that caused the error.
+   * @param reason - An optional reason for the error
+   */ constructor(files, reason){
+        super("Invalid files");
+        _define_property(this, "files", void 0);
+        _define_property(this, "reason", void 0);
+        /**
+   * A unique key generated by `nanoid` that can be used as a `React` key
+   */ _define_property(this, "key", void 0);
+        this.files = files;
+        this.reason = reason;
+        this.key = nanoid();
+        this.name = "GenericFileError";
+    }
+}
+/**
+ * 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
+ */ export class TooManyFilesError extends GenericFileError {
+    /**
+   *
+   * @param files - The list of files that could not be uploaded due to the file
+   * limit defined.
+   * @param limit - The max limit of files allowed.
+   */ constructor(files, limit){
+        super(files, "file limit");
+        _define_property(this, "limit", void 0);
+        this.limit = limit;
+        this.name = "TooManyFilesError";
+    }
+}
+/**
+ * An error that will be created if a user tries to upload a file that
+ * is either:
+ * - less than the {@link FileValidationOptions.minFileSize}
+ * - greater than the {@link FileValidationOptions.maxFileSize}
+ * - including the file would be greater than the {@link FileValidationOptions.totalFileSize}
+ *
+ * @remarks \@since 2.9.0
+ */ export class FileSizeError extends GenericFileError {
+    /**
+   *
+   * @param files - The list of files that have the file size error
+   * @param type - The file size error type
+   * @param limit - The number of bytes allowed based on the type
+   */ constructor(files, type, limit){
+        super(files, "file size");
+        _define_property(this, "type", void 0);
+        _define_property(this, "limit", void 0);
+        this.type = type;
+        this.limit = limit;
+        this.name = "FileSizeError";
+    }
+}
+/**
+ * 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
+ */ export class FileExtensionError extends GenericFileError {
+    /**
+   *
+   * @param files - The file that caused the error
+   * @param extensions - The allowed list of file extensions
+   */ constructor(files, extensions){
+        super(files, "extension");
+        _define_property(this, "extensions", void 0);
+        this.extensions = extensions;
+        this.name = "FileExtensionError";
+    }
+}
+/**
+ * A simple type-guard that can be used to check if the
+ * {@link FileValidationError} is the {@link GenericFileError} which can be
+ * useful when displaying the errors to the user.
+ *
+ * @param error - The error to check
+ * @returns true if the error is a {@link FileAccessError}
+ */ export function isGenericFileError(error) {
+    return "name" in error && error.name === "GenericFileError";
+}
+/**
+ * A simple type-guard that can be used to check if the
+ * {@link FileValidationError} is the {@link FileAccessError} which can be
+ * useful when displaying the errors to the user.
+ *
+ * @param error - The error to check
+ * @returns true if the error is a {@link FileAccessError}
+ */ export function isFileAccessError(error) {
+    return "name" in error && error.name === "FileAccessError";
+}
+/**
+ * A simple type-guard that can be used to check if the
+ * {@link FileValidationError} is the {@link TooManyFilesError} which can be
+ * useful when displaying the errors to the user.
+ *
+ * @param error - The error to check
+ * @returns true if the error is a {@link TooManyFilesError}
+ */ export function isTooManyFilesError(error) {
+    return "name" in error && error.name === "TooManyFilesError";
+}
+/**
+ * A simple type-guard that can be used to check if the
+ * {@link FileValidationError} is the {@link FileSizeError} which can be
+ * useful when displaying the errors to the user.
+ *
+ * @param error - The error to check
+ * @returns true if the error is a {@link FileSizeError}
+ */ export function isFileSizeError(error) {
+    return "name" in error && error.name === "FileSizeError";
+}
+/**
+ * A simple type-guard that can be used to check if the
+ * {@link FileValidationError} is the {@link FileExtensionError} which can be
+ * useful when displaying the errors to the user.
+ *
+ * @param error - The error to check
+ * @returns true if the error is a {@link FileExtensionError}
+ */ export function isFileExtensionError(error) {
+    return "name" in error && error.name === "FileExtensionError";
+}
+/**
+ *
+ * @defaultValue `matcher?.test(file.name) ?? true`
+ * @remarks \@since 3.1.0
+ */ export const isValidFileName = (file, matcher)=>matcher?.test(file.name) ?? true;
+/**
+ * A pretty decent default implementation for validating files with the
+ * {@link useFileUpload} that ensures the {@link FilesValidationOptions} are
+ * enforced before allowing a file to be uploaded.
+ *
+ * @typeparam E - An optional custom file validation error.
+ * @param files - The list of files to check
+ * @param options - The {@link FilesValidationOptions}
+ * @returns the {@link ValidatedFilesResult}
+ * @remarks \@since 2.9.0
+ */ export function validateFiles(files, { maxFiles, extensions, minFileSize, maxFileSize, totalBytes, totalFiles, totalFileSize, isValidFileName }) {
+    const errors = [];
+    const pending = [];
+    const extraFiles = [];
+    const extensionRegExp = extensions.length > 0 ? new RegExp(`\\.(${extensions.join("|")})$`, "i") : undefined;
+    let maxFilesReached = maxFiles > 0 && totalFiles >= maxFiles;
+    let remainingBytes = totalFileSize - totalBytes;
+    const extensionErrors = [];
+    const minErrors = [];
+    const maxErrors = [];
+    const totalSizeErrors = [];
+    for(let i = 0; i < files.length; i += 1){
+        const file = files[i];
+        let valid = true;
+        const { size } = file;
+        if (!isValidFileName(file, extensionRegExp, extensions)) {
+            valid = false;
+            extensionErrors.push(file);
+        }
+        if (minFileSize > 0 && size < minFileSize) {
+            valid = false;
+            minErrors.push(file);
+        }
+        if (maxFileSize > 0 && size > maxFileSize) {
+            valid = false;
+            maxErrors.push(file);
+        } else if (totalFileSize > 0 && remainingBytes - file.size < 0) {
+            // don't want both errors displaying
+            valid = false;
+            totalSizeErrors.push(file);
+        }
+        if (maxFilesReached && valid) {
+            extraFiles.push(file);
+        } else if (!maxFilesReached && valid) {
+            pending.push(file);
+            remainingBytes -= file.size;
+            maxFilesReached = maxFilesReached || maxFiles > 0 && totalFiles + pending.length >= maxFiles;
+        }
+    }
+    if (extensionErrors.length) {
+        errors.push(new FileExtensionError(extensionErrors, extensions));
+    }
+    if (minErrors.length) {
+        errors.push(new FileSizeError(minErrors, "min", minFileSize));
+    }
+    if (maxErrors.length) {
+        errors.push(new FileSizeError(maxErrors, "max", maxFileSize));
+    }
+    if (totalSizeErrors.length) {
+        errors.push(new FileSizeError(totalSizeErrors, "total", totalFileSize));
+    }
+    if (extraFiles.length) {
+        errors.push(new TooManyFilesError(extraFiles, maxFiles));
+    }
+    return {
+        pending,
+        errors
+    };
+}
+/**
+ * This will first check if the mime-type of the file starts with `text/` and
+ * fallback to checking a few file names or extensions that should be considered
+ * text.
+ *
+ * This function is not guaranteed to be 100% correct and is only useful if
+ * trying to generate a preview of files uploaded to the browser.
+ *
+ * @param file - The file to check
+ * @returns `true` if the file should be considered as a text-content file.
+ * @remarks \@since 2.9.0
+ */ export function isTextFile(file) {
+    return /\.((j|t)sx?|json|lock|hbs|ya?ml|log|txt|md)$/i.test(file.name);
+}
+/**
+ * This will first check if the mime-type of the file starts with `text\/` and
+ * fallback to checking a few file names or extensions that should be considered
+ * text.
+ *
+ * This function is not guaranteed to be 100% correct and is only useful if
+ * trying to generate a preview of files uploaded to the browser.
+ *
+ * @param file - The file to check
+ * @returns `true` if the file should be considered as a text content file.
+ * @remarks \@since 2.9.0
+ */ export function isImageFile(file) {
+    return /\.(a?png|avif|svg|tiff|gifv?|jpe?g)/i.test(file.name);
+}
+/**
+ * This will first check if the mime-type of the file starts with `audio/` and
+ * fallback to checking a few file names or extensions that should be considered
+ * audio.
+ *
+ * This function is not guaranteed to be 100% correct and is only useful if
+ * trying to generate a preview of files uploaded to the browser.
+ *
+ * @param file - The file to check
+ * @returns `true` if the file should be considered as a audio content file.
+ * @remarks \@since 2.9.0
+ */ export function isAudioFile(file) {
+    return /\.(mp3|wav|ogg|m4p|flac)$/i.test(file.name);
+}
+/**
+ * This will first check if the mime-type of the file starts with `video/` and
+ * fallback to checking a few file names or extensions that should be considered
+ * video.
+ *
+ * This function is not guaranteed to be 100% correct and is only useful if
+ * trying to generate a preview of files uploaded to the browser.
+ *
+ * @param file - The file to check
+ * @returns `true` if the file should be considered as a video content file.
+ * @remarks \@since 2.9.0
+ */ export function isVideoFile(file) {
+    return /\.(mkv|mpe?g|mov|avi|flv|webm|mp4)$/i.test(file.name);
+}
+/**
+ * This function is not guaranteed to be 100% correct and is only useful if
+ * trying to generate a preview of files uploaded to the browser.
+ *
+ * @param file - The file to check
+ * @returns `true` if the file matches an image, audio, or video file.
+ * @remarks \@since 2.9.0
+ */ export function isMediaFile(file) {
+    return isImageFile(file) || isAudioFile(file) || isVideoFile(file);
+}
+/**
+ * This function will attempt to read:
+ * - media (image, audio, and video) files as a data url so they can be
+ *   previewed in `<img>`, `<audio>`, and `<video>` tags
+ * - text files as plain text
+ * - everything else as an `ArrayBuffer` which can be manually converted into a
+ *   data url if needed with `URL.createObjectURL`
+ *
+ * @remarks \@since 2.9.0
+ */ export const getFileParser = (file)=>{
+    if (isMediaFile(file)) {
+        return "readAsDataURL";
+    }
+    if (isTextFile(file)) {
+        return "readAsText";
+    }
+    return "readAsArrayBuffer";
+};
+/**
+ * This util will split all the current upload stats by status.
+ *
+ * @param stats - The {@link FileUploadStats} list generally returned by the
+ * {@link useFileUpload} hook.
+ * @returns the {@link SplitFileUploads}.
+ * @remarks \@since 2.9.0
+ */ export function getSplitFileUploads(stats) {
+    const pending = [];
+    const uploading = [];
+    const complete = [];
+    stats.forEach((stat)=>{
+        if (stat.status === "pending") {
+            pending.push(stat);
+        } else if (stat.status === "uploading") {
+            uploading.push(stat);
+        } else if (stat.status === "complete") {
+            complete.push(stat);
+        } else {
+            /* istanbul ignore next */ throw new Error("Invalid upload stat");
+        }
+    });
+    return {
+        pending,
+        uploading,
+        complete
+    };
+}
+
+//# sourceMappingURL=fileUtils.js.map

package/dist/form/fileUtils.js.map

@@ -0,0 +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"],"mappings":"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"}

package/dist/form/formConfig.d.ts

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

package/dist/form/formConfig.js

@@ -0,0 +1,17 @@
+/**
+ * @remarks \@since 6.0.0
+ */ export const FORM_CONFIG = {
+    theme: "outline",
+    underlineDirection: "left",
+    uncontrolledToggles: true
+};
+/**
+ * @remarks \@since 6.0.0
+ */ export function getFormConfig(name, override) {
+    if (typeof override !== "undefined") {
+        return override;
+    }
+    return FORM_CONFIG[name];
+}
+
+//# sourceMappingURL=formConfig.js.map

package/dist/form/formConfig.js.map

@@ -0,0 +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"],"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

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

package/dist/form/formMessageStyles.js

@@ -0,0 +1,28 @@
+import { cnb } from "cnbuilder";
+import { cssUtils } from "../cssUtils.js";
+import { bem } from "../utils/bem.js";
+const styles = bem("rmd-form-message");
+/**
+ * @remarks \@since 6.0.0
+ */ export function formMessage(options = {}) {
+    const { className, error = false, theme = "none" } = options;
+    return cnb(styles({
+        [theme]: theme !== "none"
+    }), cssUtils({
+        textColor: error ? "error" : "text-secondary"
+    }), className);
+}
+/**
+ * @remarks \@since 6.0.0
+ */ export function formMessageText(options = {}) {
+    const { className } = options;
+    return cnb(styles("message"), className);
+}
+/**
+ * @remarks \@since 6.0.0
+ */ export function formMessageCounter(options = {}) {
+    const { className } = options;
+    return cnb(styles("counter"), className);
+}
+
+//# sourceMappingURL=formMessageStyles.js.map

package/dist/form/formMessageStyles.js.map

@@ -0,0 +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"],"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

@@ -0,0 +1,36 @@
+import { type FormComponentStates } from "./types.js";
+/**
+ * The size to use for the `Checkbox` or `Radio` component. Each of these values
+ * except for `"auto"` map to Sass variables:
+ * - `"small"` - `$input-toggle-small-size`
+ * - `"dense"` - `$input-toggle-dense-size`
+ * - `"normal"` - `$input-toggle-large-size`
+ * - `"large"` - `$input-toggle-large-size`
+ *
+ * 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
+ */
+export type InputToggleSize = "auto" | "small" | "dense" | "normal" | "large";
+/** @remarks \@since 6.0.0 */
+export interface InputToggleClassNameOptions extends Omit<FormComponentStates, "readOnly"> {
+    className?: string;
+    type: "checkbox" | "radio";
+    /**
+     * Set the icon size to `1em` to allow easy sizing through font size.
+     *
+     * @defaultValue `true`
+     */
+    em?: boolean;
+    /**
+     * @see {@link InputToggleSize}
+     * @defaultValue `"auto"`
+     */
+    size?: InputToggleSize;
+    uncontrolled?: boolean;
+}
+/**
+ * @remarks \@since 6.0.0
+ */
+export declare function inputToggle(options: InputToggleClassNameOptions): string;

package/dist/form/inputToggleStyles.js

@@ -0,0 +1,23 @@
+import { cnb } from "cnbuilder";
+import { cssUtils } from "../cssUtils.js";
+import { bem } from "../utils/bem.js";
+const styles = bem("rmd-input-toggle");
+/**
+ * @remarks \@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({
+        em,
+        active: active && !disabled,
+        disabled,
+        small: size === "small",
+        dense: size === "dense",
+        normal: size === "normal",
+        large: size === "large",
+        uncontrolled
+    }), cssUtils({
+        textColor: disabled ? "text-disabled" : error ? "error" : undefined
+    }), className);
+}
+
+//# sourceMappingURL=inputToggleStyles.js.map

package/dist/form/inputToggleStyles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/form/inputToggleStyles.ts"],"sourcesContent":["import { cnb } from \"cnbuilder\";\nimport { cssUtils } from \"../cssUtils.js\";\nimport { bem } from \"../utils/bem.js\";\nimport { type FormComponentStates } from \"./types.js\";\n\nconst styles = bem(\"rmd-input-toggle\");\n\n/**\n * The size to use for the `Checkbox` or `Radio` component. Each of these values\n * except for `\"auto\"` map to Sass variables:\n * - `\"small\"` - `$input-toggle-small-size`\n * - `\"dense\"` - `$input-toggle-dense-size`\n * - `\"normal\"` - `$input-toggle-large-size`\n * - `\"large\"` - `$input-toggle-large-size`\n *\n * When this is set to `\"auto\"`, the size will be determined by the current\n * `font-size` of the `Label` element.\n *\n * @remarks \\@since 6.0.0\n */\nexport type InputToggleSize = \"auto\" | \"small\" | \"dense\" | \"normal\" | \"large\";\n\n/** @remarks \\@since 6.0.0 */\nexport interface InputToggleClassNameOptions\n  extends Omit<FormComponentStates, \"readOnly\"> {\n  className?: string;\n  type: \"checkbox\" | \"radio\";\n\n  /**\n   * Set the icon size to `1em` to allow easy sizing through font size.\n   *\n   * @defaultValue `true`\n   */\n  em?: boolean;\n\n  /**\n   * @see {@link InputToggleSize}\n   * @defaultValue `\"auto\"`\n   */\n  size?: InputToggleSize;\n\n  uncontrolled?: boolean;\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport function inputToggle(options: InputToggleClassNameOptions): string {\n  const {\n    className,\n    em = true,\n    type,\n    size = \"auto\",\n    error,\n    active = false,\n    disabled = false,\n    uncontrolled,\n  } = options;\n\n  return cnb(\n    `rmd-${type}`,\n    styles({\n      em,\n      active: active && !disabled,\n      disabled,\n      small: size === \"small\",\n      dense: size === \"dense\",\n      normal: size === \"normal\",\n      large: size === \"large\",\n      uncontrolled,\n    }),\n    cssUtils({\n      textColor: disabled ? \"text-disabled\" : error ? \"error\" : undefined,\n    }),\n    className\n  );\n}\n"],"names":["cnb","cssUtils","bem","styles","inputToggle","options","className","em","type","size","error","active","disabled","uncontrolled","small","dense","normal","large","textColor","undefined"],"mappings":"AAAA,SAASA,GAAG,QAAQ,YAAY;AAChC,SAASC,QAAQ,QAAQ,iBAAiB;AAC1C,SAASC,GAAG,QAAQ,kBAAkB;AAGtC,MAAMC,SAASD,IAAI;AAuCnB;;CAEC,GACD,OAAO,SAASE,YAAYC,OAAoC;IAC9D,MAAM,EACJC,SAAS,EACTC,KAAK,IAAI,EACTC,IAAI,EACJC,OAAO,MAAM,EACbC,KAAK,EACLC,SAAS,KAAK,EACdC,WAAW,KAAK,EAChBC,YAAY,EACb,GAAGR;IAEJ,OAAOL,IACL,CAAC,IAAI,EAAEQ,KAAK,CAAC,EACbL,OAAO;QACLI;QACAI,QAAQA,UAAU,CAACC;QACnBA;QACAE,OAAOL,SAAS;QAChBM,OAAON,SAAS;QAChBO,QAAQP,SAAS;QACjBQ,OAAOR,SAAS;QAChBI;IACF,IACAZ,SAAS;QACPiB,WAAWN,WAAW,kBAAkBF,QAAQ,UAAUS;IAC5D,IACAb;AAEJ"}

package/dist/form/nativeSelectStyles.d.ts

@@ -0,0 +1,26 @@
+/** @remarks \@since 6.0.0 */
+export interface NativeSelectClassNameOptions {
+    className?: string;
+    /**
+     * Set to `true` if using a custom icon instead of the default `<select>`
+     * appearance.
+     *
+     * @defaultValue `false`
+     */
+    icon?: boolean;
+}
+/** @remarks \@since 6.0.0 */
+export declare function nativeSelect(options?: NativeSelectClassNameOptions): string;
+/**
+ * @remarks \@since 6.0.0
+ */
+export interface NativeSelectContainerClassNameOptions {
+    className?: string;
+    label?: boolean;
+    multiple?: boolean;
+    underlined?: boolean;
+}
+/**
+ * @remarks \@since 6.0.0
+ */
+export declare function nativeSelectContainer(options?: NativeSelectContainerClassNameOptions): string;

package/dist/form/nativeSelectStyles.js

@@ -0,0 +1,23 @@
+import { cnb } from "cnbuilder";
+import { bem } from "../utils/bem.js";
+const styles = bem("rmd-native-select");
+const containerStyles = bem("rmd-native-select-container");
+/** @remarks \@since 6.0.0 */ export function nativeSelect(options = {}) {
+    const { className, icon = false } = options;
+    return cnb(styles({
+        icon
+    }), className);
+}
+/**
+ * @remarks \@since 6.0.0
+ */ export function nativeSelectContainer(options = {}) {
+    const { className, label, multiple, underlined } = options;
+    return cnb(containerStyles({
+        multi: multiple,
+        padded: label && multiple && !underlined,
+        underline: multiple && underlined,
+        "underline-padded": label && multiple && underlined
+    }), className);
+}
+
+//# sourceMappingURL=nativeSelectStyles.js.map

package/dist/form/nativeSelectStyles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/form/nativeSelectStyles.ts"],"sourcesContent":["import { cnb } from \"cnbuilder\";\nimport { bem } from \"../utils/bem.js\";\n\nconst styles = bem(\"rmd-native-select\");\nconst containerStyles = bem(\"rmd-native-select-container\");\n\n/** @remarks \\@since 6.0.0 */\nexport interface NativeSelectClassNameOptions {\n  className?: string;\n\n  /**\n   * Set to `true` if using a custom icon instead of the default `<select>`\n   * appearance.\n   *\n   * @defaultValue `false`\n   */\n  icon?: boolean;\n}\n\n/** @remarks \\@since 6.0.0 */\nexport function nativeSelect(\n  options: NativeSelectClassNameOptions = {}\n): string {\n  const { className, icon = false } = options;\n\n  return cnb(styles({ icon }), className);\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface NativeSelectContainerClassNameOptions {\n  className?: string;\n  label?: boolean;\n  multiple?: boolean;\n  underlined?: boolean;\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport function nativeSelectContainer(\n  options: NativeSelectContainerClassNameOptions = {}\n): string {\n  const { className, label, multiple, underlined } = options;\n\n  return cnb(\n    containerStyles({\n      multi: multiple,\n      padded: label && multiple && !underlined,\n      underline: multiple && underlined,\n      \"underline-padded\": label && multiple && underlined,\n    }),\n    className\n  );\n}\n"],"names":["cnb","bem","styles","containerStyles","nativeSelect","options","className","icon","nativeSelectContainer","label","multiple","underlined","multi","padded","underline"],"mappings":"AAAA,SAASA,GAAG,QAAQ,YAAY;AAChC,SAASC,GAAG,QAAQ,kBAAkB;AAEtC,MAAMC,SAASD,IAAI;AACnB,MAAME,kBAAkBF,IAAI;AAe5B,2BAA2B,GAC3B,OAAO,SAASG,aACdC,UAAwC,CAAC,CAAC;IAE1C,MAAM,EAAEC,SAAS,EAAEC,OAAO,KAAK,EAAE,GAAGF;IAEpC,OAAOL,IAAIE,OAAO;QAAEK;IAAK,IAAID;AAC/B;AAYA;;CAEC,GACD,OAAO,SAASE,sBACdH,UAAiD,CAAC,CAAC;IAEnD,MAAM,EAAEC,SAAS,EAAEG,KAAK,EAAEC,QAAQ,EAAEC,UAAU,EAAE,GAAGN;IAEnD,OAAOL,IACLG,gBAAgB;QACdS,OAAOF;QACPG,QAAQJ,SAASC,YAAY,CAACC;QAC9BG,WAAWJ,YAAYC;QACvB,oBAAoBF,SAASC,YAAYC;IAC3C,IACAL;AAEJ"}

package/dist/form/optionStyles.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @remarks \@since 6.0.0
+ */
+export interface OptionClassNameOptions {
+    className?: string;
+    icon: boolean;
+    selected: boolean;
+}
+/**
+ * @remarks \@since 6.0.0
+ */
+export declare function option(options: OptionClassNameOptions): string;

package/dist/form/optionStyles.js

@@ -0,0 +1,14 @@
+import { cnb } from "cnbuilder";
+import { bem } from "../utils/bem.js";
+const styles = bem("rmd-option");
+/**
+ * @remarks \@since 6.0.0
+ */ export function option(options) {
+    const { className, icon, selected } = options;
+    return cnb(styles({
+        icon,
+        selected
+    }), className);
+}
+
+//# sourceMappingURL=optionStyles.js.map