@evolve.ui/core-components 1.0.0

package/hooks-D4sJ62Xl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-D4sJ62Xl.mjs","names":[],"sources":["../src/FileUpload/utils/constants.ts","../src/FileUpload/utils/getFileExtensionsFromAcceptedTypes.ts","../src/FileUpload/utils/getFilePluralizationText.ts","../src/FileUpload/utils/createMessageContext.ts","../src/FileUpload/utils/messageUtils.ts","../src/FileUpload/hooks/validation/useValidationMessages.ts","../src/FileUpload/hooks/validation/useValidationState.ts","../src/FileUpload/hooks/validation/useFileValidationLogic.ts","../src/FileUpload/providers/UploadValidationProvider.tsx","../src/FileUpload/hooks/validation/useFileValidation.ts","../src/FileUpload/hooks/filePreview/useImageFilePreviewUrl.ts"],"sourcesContent":["import { capitalize } from 'es-toolkit';\n\nimport { CommonFileTypes, DynamicMessageContext, FileErrorCode } from '../types/commonTypes';\n\nexport const builtInErrorCodes: FileErrorCode[] = ['file-invalid-type', 'file-too-large', 'too-many-files'];\n\nexport const ACCEPTED_MIME_TYPES: Record<CommonFileTypes, string[]> = {\n    documents: [\n        'application/pdf',\n        'application/msword',\n        'application/vnd.openxmlformats-officedocument.wordprocessingml.document', // .docx\n        'application/vnd.ms-excel',\n        'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', // .xlsx\n    ],\n    images: ['image/jpeg', 'image/png', 'image/gif', 'image/webp'],\n    pdfs: ['application/pdf'],\n};\n\n// Messages shown during drag (preventative)\n//DRAG MESSAGE RULES: Be short and concise. Don't use periods.\nexport const DRAG_MESSAGES = {\n    default: 'Invalid file',\n    partialUpload: {\n        'file-invalid-type': ({ fileCount = 1, filePluralizationText }: DynamicMessageContext) =>\n            `${fileCount} ${filePluralizationText} ${fileCount > 1 ? 'have' : 'has'} an invalid file type`,\n        'file-too-large': ({ formattedMaxSize }: DynamicMessageContext) =>\n            `One or more files are too large. (${formattedMaxSize} limit)`,\n        'too-many-files': ({ fileCount, filePluralizationText }: DynamicMessageContext) =>\n            `${fileCount} ${filePluralizationText} will exceed the file limit`,\n    },\n    singleFileUpload: {\n        'file-invalid-type': 'File type not supported',\n        'file-too-large': ({ formattedMaxSize }: DynamicMessageContext) =>\n            `File must be smaller than ${formattedMaxSize}`,\n        'too-many-files': ({ filePluralizationText, maxFiles }: DynamicMessageContext) =>\n            `You can only upload ${maxFiles} ${filePluralizationText}`,\n    },\n    strictUpload: {\n        'file-invalid-type': 'One or more files have an invalid file type',\n        'file-too-large': ({ formattedMaxSize }: DynamicMessageContext) =>\n            `One or more files are too large. (${formattedMaxSize} limit)`,\n        'too-many-files': ({ maxFiles, maxFilesPluralizationText }: DynamicMessageContext) =>\n            `You can only upload ${maxFiles} ${maxFilesPluralizationText}`,\n    },\n};\n\n// Messages shown after drop (error state)\n//DROP MESSAGE RULES: Guide the user on what went wrong and what they can do to move forward.\nexport const DROP_MESSAGES = {\n    default: 'Invalid file',\n    partialUpload: {\n        'file-invalid-type': ({\n            acceptedFileExtensions,\n            fileCount = 1,\n            filePluralizationText,\n        }: DynamicMessageContext) =>\n            `Failed to add ${fileCount} ${filePluralizationText} due to invalid file type. Please upload only ${acceptedFileExtensions} files.`,\n        'file-too-large': ({ fileCount = 1, filePluralizationText, formattedMaxSize }: DynamicMessageContext) =>\n            `${fileCount} ${filePluralizationText} ${fileCount > 1 ? 'are' : 'is'} too large. Please upload files smaller than ${formattedMaxSize}.`,\n        'too-many-files': ({ fileCount, filePluralizationText, maxFiles }: DynamicMessageContext) =>\n            `You've reached the ${maxFiles} file limit. ${fileCount} ${filePluralizationText} could not be added.`,\n    },\n    singleFileUpload: {\n        'file-invalid-type': ({ acceptedFileExtensions }: DynamicMessageContext) =>\n            `File type not supported. Please upload only ${acceptedFileExtensions} files.`,\n        'file-too-large': ({ formattedMaxSize }: DynamicMessageContext) =>\n            `File is too large. Please upload files smaller than ${formattedMaxSize}.`,\n        'too-many-files': ({ filePluralizationText, maxFiles }: DynamicMessageContext) =>\n            `${capitalize(filePluralizationText ?? 'files')} not added. You can only upload ${maxFiles} in total`,\n    },\n    strictUpload: {\n        'file-invalid-type': ({ acceptedFileExtensions }: DynamicMessageContext) =>\n            `One or more files have an invalid file type. Please upload only ${acceptedFileExtensions} files.`,\n        'file-too-large': ({ formattedMaxSize }: DynamicMessageContext) =>\n            `One or more files are too large. Please upload files smaller than ${formattedMaxSize}.`,\n        'too-many-files': ({ filePluralizationText, maxFiles, maxFilesPluralizationText }: DynamicMessageContext) =>\n            `${capitalize(filePluralizationText ?? 'files')} not added - maximum of ${maxFiles} ${maxFilesPluralizationText} allowed.`,\n    },\n};\n","import { CommonFileTypes } from '../types/commonTypes';\nimport { ACCEPTED_MIME_TYPES } from './constants';\n\n// Map of MIME types to their corresponding file extensions\nconst MIME_TYPE_TO_EXTENSION: Record<string, string> = {\n    'application/msword': '.doc',\n    'application/pdf': '.pdf',\n    'application/vnd.ms-excel': '.xls',\n    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': '.xlsx',\n    'application/vnd.openxmlformats-officedocument.wordprocessingml.document': '.docx',\n    'image/gif': '.gif',\n    'image/jpeg': '.jpeg',\n    'image/jpg': '.jpg',\n    'image/png': '.png',\n    'image/webp': '.webp',\n};\n\n/**\n * Converts a MIME type to its corresponding file extension\n * @param mimeType The MIME type to convert (e.g., 'image/jpeg', 'application/pdf')\n * @returns The corresponding file extension with leading dot (e.g., '.jpeg', '.pdf')\n *          or an empty string if the MIME type is invalid or incomplete\n */\nexport const getMimeTypeExtension = (mimeType: string): string => {\n    // If we have a direct mapping, use it\n    if (MIME_TYPE_TO_EXTENSION[mimeType]) {\n        return MIME_TYPE_TO_EXTENSION[mimeType];\n    }\n\n    // For simple MIME types, extract the subtype\n    const parts = mimeType.split('/');\n    if (parts.length === 2 && parts[1] && !parts[1].includes('.')) {\n        return `.${parts[1]}`;\n    }\n\n    // Return empty string for incomplete MIME types\n    return '';\n};\n\n/**\n * Converts file type restrictions into a comma-separated list of file extensions\n * @param accept - Optional file type restrictions, can be either:\n *   - A preset category from CommonFileTypes (e.g., 'images', 'pdfs', 'documents')\n *   - An array of specific file extensions (e.g., ['.jpg', '.png', '.pdf'])\n *   - An array of MIME types (e.g., ['image/jpeg', 'image/png', 'application/pdf'])\n *   - A mixed array of both extensions and MIME types\n * @returns A comma-separated string of file extensions with leading dots (e.g., '.jpg, .png, .pdf')\n *          or an empty string if no valid extensions are found or accept is undefined\n * @example\n * // Returns '.jpeg, .png, .gif, .webp, .jpg'\n * getFileExtensionsFromAcceptedTypes('images')\n *\n * // Returns '.jpg, .png, .pdf'\n * getFileExtensionsFromAcceptedTypes(['.jpg', 'image/png', 'application/pdf'])\n */\nexport const getFileExtensionsFromAcceptedTypes = (accept?: CommonFileTypes | string[]) => {\n    if (!accept) {\n        return '';\n    }\n\n    // If it's a CommonFileTypes string (e.g., 'images')\n    if (typeof accept === 'string') {\n        const mimeTypes = ACCEPTED_MIME_TYPES[accept as CommonFileTypes];\n        return mimeTypes.map(getMimeTypeExtension).join(', ');\n    }\n\n    // If it's an array of extensions/mime types\n    return accept\n        .filter(Boolean) // Remove empty strings and falsy values\n        .map((type) => (type.startsWith('.') ? type : getMimeTypeExtension(type))) // Convert MIME types to extensions\n        .filter((ext) => ext.length > 1) // Remove single-character extensions\n        .join(', ');\n};\n","import { capitalize } from 'es-toolkit';\n\nimport { CommonFileTypes } from '../types/commonTypes';\n\ntype GetFilePluralizationTextProps = {\n    accept?: CommonFileTypes | string[];\n    capitalize?: boolean;\n    count?: number;\n    hideCount?: boolean;\n};\n\nconst getBaseText = (accept?: CommonFileTypes | string[]): 'image' | 'file' => {\n    if (accept === 'images') {\n        return 'image';\n    }\n\n    if (Array.isArray(accept)) {\n        const isImageOnly = accept.every((type) => type.startsWith('image/'));\n        return isImageOnly ? 'image' : 'file';\n    }\n\n    return 'file';\n};\n\nconst pluralize = (count: number, word: string, hideCount?: boolean, capitalizeWord?: boolean) => {\n    const text = `${word}${count === 1 ? '' : 's'}`;\n    const finalText = capitalizeWord ? capitalize(text) : text;\n    return hideCount ? finalText : `${count} ${finalText}`;\n};\n\n/**\n * Generates a formatted text string for file type descriptions with proper pluralization and capitalization\n * @param props Configuration object for text formatting\n * @param props.accept - Optional file type(s) to determine if text should say \"file\" or \"image\"\n * @param props.capitalize - Optional flag to capitalize the first letter of the output\n * @param props.count - Optional number to determine pluralization (e.g., \"1 file\" vs \"2 files\")\n * @param props.hideCount - Optional flag to exclude the count from the output (e.g., \"files\" instead of \"2 files\")\n * @returns Formatted string describing file(s) or image(s)\n * @example\n * // Returns \"2 files\"\n * getFilePluralizationText({ count: 2 })\n *\n * // Returns \"1 image\"\n * getFilePluralizationText({ accept: 'images', count: 1 })\n *\n * // Returns \"Files\"\n * getFilePluralizationText({ capitalize: true, hideCount: true })\n *\n * // Returns \"Image\"\n * getFilePluralizationText({ accept: 'images', capitalize: true })\n */\nexport const getFilePluralizationText = ({\n    accept,\n    capitalize: capitalizeWord,\n    count,\n    hideCount,\n}: GetFilePluralizationTextProps = {}) => {\n    const baseText = getBaseText(accept);\n\n    if (count === undefined) {\n        if (capitalizeWord) {\n            return capitalize(baseText);\n        }\n        return baseText;\n    }\n\n    return pluralize(count, baseText, hideCount, capitalizeWord);\n};\n","import {\n    BaseDynamicMessageContext,\n    CommonFileTypes,\n    DragMessageContext,\n    DropMessageContext,\n    DynamicMessageContext,\n} from '../types/commonTypes';\nimport { getFileExtensionsFromAcceptedTypes } from './getFileExtensionsFromAcceptedTypes';\nimport { getFilePluralizationText } from './getFilePluralizationText';\n\n/**\n * Creates a base message context with properties common to both drag and drop events\n */\nexport const createBaseMessageContext = ({\n    accept,\n    code,\n    count,\n    formattedMaxSize,\n    maxFiles,\n    maxSize,\n}: {\n    accept?: CommonFileTypes | string[];\n    code: string;\n    count?: number;\n    formattedMaxSize?: string;\n    maxFiles?: number;\n    maxSize?: number;\n}): BaseDynamicMessageContext => {\n    const acceptedFileExtensions = getFileExtensionsFromAcceptedTypes(accept);\n\n    const filePluralizationText = getFilePluralizationText({\n        accept,\n        count,\n        hideCount: true,\n    });\n\n    const maxFilesPluralizationText = getFilePluralizationText({\n        accept,\n        count: maxFiles,\n        hideCount: true,\n    });\n\n    return {\n        acceptedFileExtensions,\n        errorCode: code,\n        ...(count !== undefined && { fileCount: count }),\n        filePluralizationText,\n        formattedMaxSize,\n        maxFiles,\n        maxFilesPluralizationText,\n        maxSizeBytes: maxSize,\n    };\n};\n\n/**\n * Creates a message context for drag events\n */\nexport const createDragMessageContext = ({\n    accept,\n    code,\n    count,\n    formattedMaxSize,\n    items,\n    maxFiles,\n    maxSize,\n}: {\n    accept?: CommonFileTypes | string[];\n    code: string;\n    count?: number;\n    formattedMaxSize?: string;\n    items?: DataTransferItemList;\n    maxFiles?: number;\n    maxSize?: number;\n}): DragMessageContext => {\n    const baseContext = createBaseMessageContext({\n        accept,\n        code,\n        count,\n        formattedMaxSize,\n        maxFiles,\n        maxSize,\n    });\n\n    return {\n        ...baseContext,\n        ...(items && { draggedItems: items }),\n        eventType: 'drag',\n    };\n};\n\n/**\n * Creates a message context for drop events\n */\nexport const createDropMessageContext = ({\n    accept,\n    code,\n    count,\n    files,\n    formattedMaxSize,\n    maxFiles,\n    maxSize,\n}: {\n    accept?: CommonFileTypes | string[];\n    code: string;\n    count?: number;\n    files?: File[];\n    formattedMaxSize?: string;\n    maxFiles?: number;\n    maxSize?: number;\n}): DropMessageContext => {\n    const baseContext = createBaseMessageContext({\n        accept,\n        code,\n        count,\n        formattedMaxSize,\n        maxFiles,\n        maxSize,\n    });\n\n    const rejectedFileList = files?.map((f) => f.name).join(', ') ?? '';\n\n    return {\n        ...baseContext,\n        eventType: 'drop',\n        rejectedFileList,\n        ...(files && { rejectedFiles: files }),\n    };\n};\n\n/**\n * Unified function to create the appropriate message context based on the message type\n *\n * @param params Common parameters for both context types\n * @param params.messageType The type of message context to create ('drag' or 'drop')\n * @param params.dragItems Optional DataTransferItemList for drag events\n * @param params.dropFiles Optional File[] for drop events (only newly dropped files can be rejected)\n * @returns The appropriate message context based on the message type\n */\nexport const createMessageContext = ({\n    accept,\n    code,\n    count,\n    dragItems,\n    dropFiles,\n    formattedMaxSize,\n    maxFiles,\n    maxSize,\n    messageType = 'drop',\n}: {\n    accept?: CommonFileTypes | string[];\n    code: string;\n    count?: number;\n    dragItems?: DataTransferItemList;\n    dropFiles?: File[];\n    formattedMaxSize?: string;\n    maxFiles?: number;\n    maxSize?: number;\n    messageType?: 'drag' | 'drop';\n}): DynamicMessageContext => {\n    const baseParams = {\n        accept,\n        code,\n        count,\n        formattedMaxSize,\n        maxFiles,\n        maxSize,\n    };\n\n    if (messageType === 'drag') {\n        return createDragMessageContext({\n            ...baseParams,\n            items: dragItems,\n        });\n    }\n\n    return createDropMessageContext({\n        ...baseParams,\n        files: dropFiles,\n    });\n};\n","import { ContextAwareMessage } from '../types/commonTypes';\n\n/**\n * Processes any type of message into a string\n * @param message - A string, function that returns a string, or undefined\n * @param context - The context object to pass to the message function (optional)\n * @param defaultMessage - Optional fallback message used when the primary message is undefined\n *                         or when the primary message is a function but context is undefined\n * @returns A string message. If a function message is provided, its result is converted to a string.\n *          Returns an empty string if no valid message can be resolved.\n */\nexport const resolveContextAwareMessage = <T>(\n    message: ContextAwareMessage<T> | undefined,\n    context?: T,\n    defaultMessage?: ContextAwareMessage<T>\n): string => {\n    // Handle undefined message\n    if (!message) {\n        // Use default message if provided\n        if (defaultMessage) {\n            return resolveContextAwareMessage(defaultMessage, context);\n        }\n        return '';\n    }\n\n    // Handle function message\n    if (typeof message === 'function') {\n        // Ensure we have a context to pass to the function\n        if (context) {\n            return String(message(context));\n        }\n        // If no context but we have a default, use it\n        if (defaultMessage) {\n            return resolveContextAwareMessage(defaultMessage, context);\n        }\n        return '';\n    }\n\n    // Handle string message\n    return message;\n};\n","import { useCallback } from 'react';\n\nimport { formatFileSize } from '../../../utils/formatFileSize';\nimport { CommonFileTypes, ValidationMessageParams } from '../../types/commonTypes';\nimport { DRAG_MESSAGES, DROP_MESSAGES } from '../../utils/constants';\nimport { createMessageContext } from '../../utils/createMessageContext';\nimport { resolveContextAwareMessage } from '../../utils/messageUtils';\n\nconst getMessageSet = (\n    messages: typeof DRAG_MESSAGES | typeof DROP_MESSAGES,\n    isSingleFileUpload: boolean,\n    strictValidation?: boolean\n) => {\n    // Determine which message set to use\n    if (isSingleFileUpload) {\n        return messages.singleFileUpload;\n    }\n\n    if (strictValidation) {\n        return messages.strictUpload;\n    }\n\n    return messages.partialUpload;\n};\n\ntype UseValidationMessagesProps = {\n    /** Optional array of accepted file types */\n    accept?: CommonFileTypes | string[];\n    /** Maximum allowed file size in bytes (Unrestricted by default) */\n    maxFiles?: number;\n    /** Maximum number of files (1 for single file, undefined for unlimited) */\n    maxSize?: number;\n    /** Whether to use strict validation */\n    strictValidation?: boolean;\n};\n\n/**\n * Hook that manages validation message generation for file uploads\n * @param props Configuration object\n * @param props.accept - Optional array of accepted file types or CommonFileTypes\n * @param props.maxFiles - Optional maximum number of files allowed\n * @param props.maxSize - Optional maximum file size in bytes\n * @param props.strictValidation - Optional flag for strict validation mode\n * @returns Object containing:\n *   - formattedMaxSize: Human-readable maximum file size (e.g., \"5 MB\")\n *   - getValidationMessage: Function to get validation messages based on error codes and context\n * @remarks\n * - Handles both drag and drop validation messages\n * - Supports custom error messages\n * - Formats file size limits in human-readable format\n * - Handles pluralization for file count messages\n */\nexport const useValidationMessages = ({ accept, maxFiles, maxSize, strictValidation }: UseValidationMessagesProps) => {\n    const formattedMaxSize = maxSize ? formatFileSize(maxSize) : undefined;\n    const isSingleFileUpload = maxFiles === 1;\n\n    const getValidationMessage = useCallback(\n        ({ code, count = 1, message: customMessage, messageType = 'drop' }: ValidationMessageParams): string => {\n            const messages = messageType === 'drag' ? DRAG_MESSAGES : DROP_MESSAGES;\n\n            // Create the appropriate context based on message type\n            const messageContext = createMessageContext({\n                accept,\n                code,\n                count,\n                formattedMaxSize,\n                maxFiles,\n                maxSize,\n                messageType,\n            });\n\n            // If we have a custom message, use it\n            if (customMessage) {\n                return resolveContextAwareMessage(customMessage, messageContext);\n            }\n\n            // Otherwise use built-in messages\n            const messageSet = getMessageSet(messages, isSingleFileUpload, strictValidation);\n            // @ts-expect-error - we know the code exists in messageSet\n            const message = messageSet[code];\n\n            // Use the message or fall back to default\n            return resolveContextAwareMessage(message, messageContext, messages.default);\n        },\n        [formattedMaxSize, isSingleFileUpload, maxFiles, accept, strictValidation, maxSize]\n    );\n\n    return {\n        formattedMaxSize,\n        getValidationMessage,\n    };\n};\n","import { useCallback, useEffect, useState } from 'react';\n\nimport { FileError, FileErrorCode, FileRejection } from '../../types';\n\n/**\n * Hook that manages validation state for file upload operations\n * @param initialError - Optional initial validation error to display\n * @param getValidationMessage - Function to get validation messages\n * @returns Object containing:\n *   - dragValidationErrors: Validation errors during drag operations\n *   - dropValidationErrors: Validation errors during drop operations\n *   - fileRejections: Rejected files\n *   - setDragValidation: Update drag validation state\n *   - setDropValidation: Update drop validation state\n *   - clearDragValidation: Reset drag validation state\n *   - clearDropValidation: Reset drop validation state\n *   - clearAllValidation: Reset both validation states\n * @remarks\n * - Maintains separate validation states for drag and drop operations\n * - Provides methods to update and clear validation states\n * - Supports initial error state for immediate feedback\n * - Uses memoized clear functions to prevent unnecessary rerenders\n * - Handles message processing internally\n */\nexport const useValidationState = (\n    initialError?: FileError,\n    getValidationMessage?: (params: { code: FileErrorCode; count?: number; messageType: 'drag' | 'drop' }) => string\n) => {\n    // Single error for drag (since we show one at a time during drag)\n    const [dragValidationError, setDragValidationErrorState] = useState<FileError | null>(null);\n\n    // Array of errors for drop (since multiple files can have different errors)\n    const [dropValidationErrors, setDropValidationErrorsState] = useState<FileError[]>(\n        initialError ? [initialError] : []\n    );\n\n    const [fileRejections, setFileRejections] = useState<FileRejection[]>([]);\n\n    const clearDragValidation = useCallback(() => {\n        setDragValidationErrorState(null);\n    }, []);\n\n    const clearDropValidation = useCallback(() => {\n        setDropValidationErrorsState([]);\n    }, []);\n\n    const clearAllValidation = useCallback(() => {\n        clearDragValidation();\n        clearDropValidation();\n        setFileRejections([]);\n    }, [clearDragValidation, clearDropValidation]);\n\n    // Enhanced setters that handle message processing\n    const setDragValidationError = useCallback(\n        (errorOrCode: FileError | FileErrorCode | null, count?: number) => {\n            if (errorOrCode === null) {\n                setDragValidationErrorState(null);\n                return;\n            }\n\n            // If we're given just a code, get the message from getValidationMessage\n            if (typeof errorOrCode === 'string') {\n                if (getValidationMessage) {\n                    const message = getValidationMessage({\n                        code: errorOrCode,\n                        count,\n                        messageType: 'drag',\n                    });\n                    setDragValidationErrorState({\n                        code: errorOrCode,\n                        message,\n                    });\n                } else {\n                    // Fallback if getValidationMessage is not provided\n                    setDragValidationErrorState({\n                        code: errorOrCode,\n                        message: `Error: ${errorOrCode}`,\n                    });\n                }\n            } else {\n                // If we're given a complete error object, use it directly\n                setDragValidationErrorState(errorOrCode);\n            }\n        },\n        [getValidationMessage]\n    );\n\n    const setDropValidationErrors = useCallback(\n        (errorsOrCodes: Array<FileError | FileErrorCode> | FileError | FileErrorCode, count?: number) => {\n            // Handle single error/code case\n            if (!Array.isArray(errorsOrCodes)) {\n                const errorOrCode = errorsOrCodes;\n\n                // If we're given just a code, get the message from getValidationMessage\n                if (typeof errorOrCode === 'string') {\n                    if (getValidationMessage) {\n                        const message = getValidationMessage({\n                            code: errorOrCode,\n                            count,\n                            messageType: 'drop',\n                        });\n                        setDropValidationErrorsState([\n                            {\n                                code: errorOrCode,\n                                message,\n                            },\n                        ]);\n                    } else {\n                        // Fallback if getValidationMessage is not provided\n                        setDropValidationErrorsState([\n                            {\n                                code: errorOrCode,\n                                message: `Error: ${errorOrCode}`,\n                            },\n                        ]);\n                    }\n                } else {\n                    // If we're given a complete error object, use it directly\n                    setDropValidationErrorsState([errorOrCode]);\n                }\n                return;\n            }\n\n            // Handle array case\n            const processedErrors = errorsOrCodes.map((errorOrCode) => {\n                // If we're given just a code, get the message from getValidationMessage\n                if (typeof errorOrCode === 'string') {\n                    if (getValidationMessage) {\n                        const message = getValidationMessage({\n                            code: errorOrCode,\n                            count,\n                            messageType: 'drop',\n                        });\n                        return {\n                            code: errorOrCode,\n                            message,\n                        };\n                    }\n                    // Fallback if getValidationMessage is not provided\n                    return {\n                        code: errorOrCode,\n                        message: `Error: ${errorOrCode}`,\n                    };\n                }\n                // If we're given a complete error object, use it directly\n                return errorOrCode;\n            });\n\n            setDropValidationErrorsState(processedErrors);\n        },\n        [getValidationMessage]\n    );\n\n    // Effect to synchronize drop errors if the initialError prop changes post-mount.\n    // Uses the raw state setter and only depends on initialError to avoid performance issues.\n    useEffect(() => {\n        setDropValidationErrorsState(initialError ? [initialError] : []);\n    }, [initialError]);\n\n    return {\n        clearAllValidation,\n        clearDragValidation,\n        clearDropValidation,\n        dragValidationError,\n        dropValidationErrors,\n        fileRejections,\n        setDragValidationError,\n        setDropValidationErrors,\n        setFileRejections,\n    };\n};\n","import { useCallback } from 'react';\n\nimport { ValidationConfig } from '../../types/commonTypes';\nimport { useValidationMessages } from './useValidationMessages';\nimport { useValidationState } from './useValidationState';\n\n/**\n * Hook that implements core file validation logic and state management\n *\n * This hook serves as the foundation for file validation throughout the upload system.\n * It combines validation state management with validation logic functions, allowing\n * for comprehensive file validation with customizable rules.\n *\n * @param config - Optional validation configuration object containing:\n *   - accept: Optional array of accepted file types or preset categories\n *   - error: Custom error object to override default validation errors\n *   - maxFiles: Maximum number of files allowed (1 for single file upload)\n *   - maxSize: Maximum file size in bytes\n *   - strictValidation: When true, all files are rejected if any fail validation\n *   - validator: Custom validation function for additional rules\n *\n * @returns An object containing:\n *   - Validation state (dragValidationError, dropValidationErrors)\n *   - State management methods (clearDragValidation, clearDropValidation, etc.)\n *   - formattedMaxSize: Human-readable size limit (e.g., \"5 MB\")\n *   - getValidationMessage: Function to generate context-aware error messages\n *   - Validation methods:\n *     - validateFileType: Checks if a file type is allowed\n *     - validateFileSize: Checks if a file is within size limits\n *     - validateFileCount: Checks if adding files would exceed limit\n *     - validateCustomRules: Applies custom validation function if provided\n */\nexport const useFileValidationLogic = (config?: ValidationConfig) => {\n    const { accept, error, maxFiles, maxSize, strictValidation, validator } = config ?? {};\n\n    // Get message formatting and validation message utilities\n    const { formattedMaxSize, getValidationMessage } = useValidationMessages({\n        ...config,\n        accept,\n    });\n\n    // Initialize validation state, optionally with custom error\n    const validationState = useValidationState(error, getValidationMessage);\n\n    // Validation methods\n    // Check if a file type is allowed given mimeTypes mapping\n    const validateFileType = useCallback((fileType: string, mimeTypes?: Record<string, string[]>) => {\n        if (!mimeTypes) {\n            return true;\n        }\n        return Object.keys(mimeTypes).includes(fileType);\n    }, []);\n\n    // Check if file size is within configured limit\n    const validateFileSize = useCallback(\n        (fileSize: number) => {\n            if (!maxSize) {\n                return true;\n            }\n            return fileSize <= maxSize;\n        },\n        [maxSize]\n    );\n\n    // Check if adding files would exceed maximum count\n    const validateFileCount = useCallback(\n        (currentCount: number, newCount: number) => {\n            if (!maxFiles) {\n                return true;\n            }\n            return currentCount + newCount <= maxFiles;\n        },\n        [maxFiles]\n    );\n\n    // Run custom validator function if provided\n    const validateCustomRules = useCallback(\n        (file: File | DataTransferItem) => {\n            if (!validator) {\n                return null;\n            }\n            const validationResult = validator(file);\n\n            // If validation result is null or empty array, return null\n            if (!validationResult || validationResult.length === 0) {\n                return null;\n            }\n\n            // Return the array of errors\n            return validationResult;\n        },\n        [validator]\n    );\n\n    return {\n        ...validationState,\n        formattedMaxSize,\n        getValidationMessage,\n        maxFiles,\n        maxSize,\n        strictValidation,\n        validateCustomRules,\n        validateFileCount,\n        validateFileSize,\n        validateFileType,\n    };\n};\n","import { createContext, useContext, useMemo, useState } from 'react';\n\nimport { useFileValidationLogic } from '../hooks/validation/useFileValidationLogic';\nimport {\n    CommonFileTypes,\n    FileError,\n    FileRejection,\n    FileValidator,\n    ValidationMessageParams,\n} from '../types/commonTypes';\n\n/**\n * Provider component that shares file validation logic and state across components\n * @param props Object containing:\n *   - accept: Optional file type restrictions (MIME types or preset categories)\n *   - children: React child components\n *   - error: Optional custom validation error object\n *   - maxFiles: Optional maximum number of files allowed (1 for single file, undefined for unlimited)\n *   - maxSize: Optional maximum file size in bytes\n *   - strictValidation: Optional boolean to enable strict validation\n *   - validator: Optional custom validation function\n * @returns Provider component with shared validation context\n * @remarks\n * - Components can access validation through useValidationContext hook\n * - If no provider is present, components will fall back to local validation logic\n * - Validation state is shared between drag and drop operations\n * - Errors must be explicitly set using the provided setter methods (setDragValidationError, setDropValidationErrors)\n */\n\nexport type UploadValidationContextType = {\n    /** Accepted file types - either preset categories or an array of MIME types */\n    accept?: CommonFileTypes | string[];\n    /** Clears all validation errors (both drag and drop errors) */\n    clearAllValidation: () => void;\n    /** Clears drag-related validation errors */\n    clearDragValidation: () => void;\n    /** Clears drop-related validation errors */\n    clearDropValidation: () => void;\n    /** Current drag validation error or null if none */\n    dragValidationError: FileError | null;\n    /** Array of drop validation errors */\n    dropValidationErrors: FileError[];\n    /** Files that failed validation with their rejection reasons */\n    fileRejections: FileRejection[];\n    /** Human-readable maximum file size (e.g., \"5 MB\") */\n    formattedMaxSize: string | undefined;\n    /** Generates context-aware validation messages */\n    getValidationMessage: (params: ValidationMessageParams) => string;\n    /** Maximum number of files allowed (1 for single file upload) */\n    maxFiles?: number;\n    /** Maximum file size in bytes */\n    maxSize?: number;\n    /** Sets the drag validation error */\n    setDragValidationError: (error: FileError | null) => void;\n    /** Sets the drop validation errors array */\n    setDropValidationErrors: (errors: FileError[]) => void;\n    /** Updates the file rejections array */\n    setFileRejections: (rejections: FileRejection[]) => void;\n    /** When true, all files are rejected if any fail validation */\n    strictValidation?: boolean;\n    /** Custom validation function for additional file checks */\n    validateCustomRules: FileValidator;\n    /** Validates if adding new files would exceed the maximum file count */\n    validateFileCount: (currentCount: number, newCount: number) => boolean;\n    /** Checks if a file size is within the allowed limit */\n    validateFileSize: (fileSize: number) => boolean;\n    /** Validates file type against accepted types */\n    validateFileType: (fileType: string, mimeTypes?: Record<string, string[]>) => boolean;\n};\n\nexport const UploadValidationContext = createContext<UploadValidationContextType | undefined>(undefined);\n\nexport type UploadValidationProviderProps = {\n    /** Optional array of accepted file types */\n    accept?: CommonFileTypes | string[];\n    /** React children */\n    children: React.ReactNode;\n    /** Error object to display custom validation errors */\n    error?: FileError;\n    /** Maximum number of files (1 for single file, undefined for unlimited) */\n    maxFiles?: number;\n    /** Maximum allowed file size in bytes (Unrestricted by default) */\n    maxSize?: number;\n    /** Enable strict validation */\n    strictValidation?: boolean;\n    /** Custom validator function */\n    validator?: FileValidator;\n};\n\nexport const UploadValidationProvider = ({\n    accept,\n    children,\n    error,\n    maxFiles,\n    maxSize,\n    strictValidation,\n    validator,\n}: UploadValidationProviderProps) => {\n    const validation = useFileValidationLogic({\n        accept,\n        error,\n        maxFiles,\n        maxSize,\n        strictValidation,\n        validator,\n    });\n\n    const [fileRejections, setFileRejections] = useState<FileRejection[]>([]);\n\n    const value = useMemo(\n        () => ({\n            ...validation,\n            accept,\n            fileRejections,\n            maxFiles,\n            maxSize,\n            setFileRejections,\n            strictValidation,\n        }),\n        [validation, accept, maxFiles, maxSize, strictValidation, fileRejections]\n    );\n\n    return <UploadValidationContext.Provider value={value}>{children}</UploadValidationContext.Provider>;\n};\n\nUploadValidationProvider.displayName = 'UploadValidationProvider';\n\n/**\n * Hook to access the upload validation context\n *\n * Provides access to validation state, error handling, and validation methods\n * for file upload components.\n *\n * @returns The UploadValidationContextType object with validation state and methods\n * @throws Error if used outside of an UploadValidationProvider\n *\n * @example\n * ```tsx\n * const validation = useValidationContext();\n *\n * // Validate file type\n * const isValidType = validation.validateFileType(file.type);\n *\n * // Set validation error\n * if (!isValidType) {\n *   validation.setDragValidationError({\n *     code: 'invalid-file-type',\n *     message: 'File type not supported'\n *   });\n * }\n * ```\n */\nexport const useValidationContext = () => {\n    const context = useContext<UploadValidationContextType | undefined>(UploadValidationContext);\n    if (!context) {\n        throw new Error('useValidationContext must be used within UploadValidationProvider');\n    }\n    return context;\n};\n","import { useContext } from 'react';\n\nimport { UploadValidationContext, UploadValidationContextType } from '../../providers/UploadValidationProvider';\nimport { ValidationConfig } from '../../types/commonTypes';\nimport { useFileValidationLogic } from './useFileValidationLogic';\n\n/**\n * Hook that provides file validation functionality by either using a shared validation context\n * or falling back to local validation logic\n * @param config - Optional validation configuration for file constraints (size, type, etc.)\n * @returns Validation context containing validation state and useful validation methods\n * @remarks\n * - If used within an UploadValidationProvider, returns the shared validation context\n * - Otherwise, creates a local validation context using useFileValidationLogic\n * - This allows components to work with or without a shared validation context\n */\nexport const useFileValidation = (config?: ValidationConfig): UploadValidationContextType => {\n    const validationContext = useContext<UploadValidationContextType | undefined>(UploadValidationContext);\n\n    // Create local validation logic\n    const localValidation = useFileValidationLogic(config);\n\n    // Return the context if it exists, otherwise use local validation\n    return validationContext ?? localValidation;\n};\n","import { useEffect, useState } from 'react';\n\nimport { FileResource } from '../../types';\n\n/**\n * Hook to manage file preview URLs with proper cleanup\n * @param file - File to preview\n * @returns Preview URL for image files, undefined for non-image files\n */\n\n// -->  Cleans up any existing URL before creating a new one\n// -->  Handles cleanup when the file prop changes\n// -->  Is more memory-efficient since it immediately revokes unused URLs\n// -->  URLs are created only when needed (in the view)\n// -->  Cleanup is tied directly to component lifecycle - handles cleanup on unmount\n// -->  URLs are managed closer to where they're actually used\n// -->  It's more efficient since previews are only created for visible components\n\nexport const useImageFilePreviewUrl = (file?: FileResource) => {\n    const [previewUrl, setPreviewUrl] = useState<string | undefined>();\n\n    useEffect(() => {\n        if (!file) {\n            return;\n        }\n\n        // If the file is a RemoteFile (has url property), use the url directly\n        if ('url' in file && file.url) {\n            setPreviewUrl(file.url);\n            return;\n        }\n\n        // At this point, file must be a File object\n        const fileObj = file as File;\n        const isImageFile = fileObj.type.startsWith('image/');\n\n        // Only create URL for image files\n        if (!isImageFile) {\n            return;\n        }\n\n        // Clean up previous URL before creating new one\n        if (previewUrl) {\n            URL.revokeObjectURL(previewUrl);\n        }\n\n        // Create preview URL\n        const url = URL.createObjectURL(fileObj);\n        setPreviewUrl(url);\n\n        // Cleanup\n        return () => {\n            if (url) {\n                URL.revokeObjectURL(url);\n            }\n        };\n        //Ignore, as this is a cleanup function - adding previewUrl could cause infinite re-renders\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [file]);\n\n    return previewUrl;\n};\n"],"mappings":"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"}

package/hooks-DDMD_CDN.cjs

@@ -0,0 +1,27 @@
+const require_featureFlagProvider = require("./featureFlagProvider-Cl66ibpA.cjs");
+//#region src/FeatureFlags/hooks/useFeatureFlag.tsx
+/**
+* Hook to check if a specific feature flag is enabled
+* @param key - The feature flag key to check
+* @returns `true` if the feature flag exists and is enabled, `false` otherwise
+*
+* @example
+* ```tsx
+* const isGreenHomePage = useFeatureFlag('ff_team-1234_home-page-is-green');
+* if (isGreenHomePage) {
+*   return <GreenHomePage />;
+* }
+* ```
+*/
+const useFeatureFlag = (key) => {
+	return require_featureFlagProvider.useFeatureFlagsContext()[key] === true;
+};
+//#endregion
+Object.defineProperty(exports, "useFeatureFlag", {
+	enumerable: true,
+	get: function() {
+		return useFeatureFlag;
+	}
+});
+
+//# sourceMappingURL=hooks-DDMD_CDN.cjs.map

package/hooks-DDMD_CDN.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-DDMD_CDN.cjs","names":["useFeatureFlagsContext"],"sources":["../src/FeatureFlags/hooks/useFeatureFlag.tsx"],"sourcesContent":["import { useFeatureFlagsContext } from '../../providers/featureFlagProvider';\n\n/**\n * Hook to check if a specific feature flag is enabled\n * @param key - The feature flag key to check\n * @returns `true` if the feature flag exists and is enabled, `false` otherwise\n *\n * @example\n * ```tsx\n * const isGreenHomePage = useFeatureFlag('ff_team-1234_home-page-is-green');\n * if (isGreenHomePage) {\n *   return <GreenHomePage />;\n * }\n * ```\n */\nexport const useFeatureFlag = (key: string): boolean => {\n    const featureFlags = useFeatureFlagsContext();\n    return featureFlags[key] === true;\n};\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAa,kBAAkB,QAAyB;CAEpD,OADqBA,4BAAAA,uBACH,CAAC,CAAC,SAAS;AACjC"}

package/horizontalScrollFadeMixin-BBr1qJpj.mjs

@@ -0,0 +1,38 @@
+import { useCallback, useMemo, useState } from "react";
+//#region src/mixins/horizontalScrollFadeMixin.ts
+const SHADOW_SCROLL_OFFSET = 5;
+const useHorizontalScrollFadeMixin = (offset = 8) => {
+	const [shouldShowLeftFade, setShouldShowLeftFade] = useState(false);
+	const [shouldShowRightFade, setShouldShowRightFade] = useState(false);
+	const calculateFadeFromElement = useCallback((elem) => {
+		const remainingOnLeft = elem.scrollLeft;
+		const remainingOnRight = elem.scrollWidth - elem.scrollLeft - elem.clientWidth;
+		setShouldShowLeftFade(remainingOnLeft - SHADOW_SCROLL_OFFSET > offset);
+		setShouldShowRightFade(remainingOnRight - SHADOW_SCROLL_OFFSET > offset);
+	}, [offset]);
+	const addEventListenerToElement = useCallback((elem) => {
+		elem.addEventListener("scroll", (event) => {
+			const elem = event.currentTarget;
+			if (!elem) return;
+			calculateFadeFromElement(elem);
+		});
+	}, [calculateFadeFromElement]);
+	const ref = useCallback((ref) => {
+		if (ref === null) return;
+		calculateFadeFromElement(ref);
+		addEventListenerToElement(ref);
+	}, [addEventListenerToElement, calculateFadeFromElement]);
+	return useMemo(() => ({
+		ref,
+		shouldShowLeftFade,
+		shouldShowRightFade
+	}), [
+		shouldShowLeftFade,
+		shouldShowRightFade,
+		ref
+	]);
+};
+//#endregion
+export { useHorizontalScrollFadeMixin as t };
+
+//# sourceMappingURL=horizontalScrollFadeMixin-BBr1qJpj.mjs.map

package/horizontalScrollFadeMixin-BBr1qJpj.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"horizontalScrollFadeMixin-BBr1qJpj.mjs","names":[],"sources":["../src/mixins/horizontalScrollFadeMixin.ts"],"sourcesContent":["import { useCallback, useMemo, useState } from 'react';\n\nconst SHADOW_SCROLL_OFFSET = 5;\n\nexport const useHorizontalScrollFadeMixin = (offset: number = 8) => {\n    const [shouldShowLeftFade, setShouldShowLeftFade] = useState(false);\n    const [shouldShowRightFade, setShouldShowRightFade] = useState(false);\n\n    const calculateFadeFromElement = useCallback(\n        (elem: HTMLElement) => {\n            const remainingOnLeft = elem.scrollLeft;\n            const remainingOnRight = elem.scrollWidth - elem.scrollLeft - elem.clientWidth;\n            setShouldShowLeftFade(remainingOnLeft - SHADOW_SCROLL_OFFSET > offset);\n            setShouldShowRightFade(remainingOnRight - SHADOW_SCROLL_OFFSET > offset);\n        },\n        [offset]\n    );\n\n    const addEventListenerToElement = useCallback(\n        (elem: HTMLElement) => {\n            elem.addEventListener('scroll', (event) => {\n                const elem = event.currentTarget as HTMLDivElement | null;\n\n                if (!elem) {\n                    return;\n                }\n\n                calculateFadeFromElement(elem);\n            });\n        },\n        [calculateFadeFromElement]\n    );\n\n    const ref = useCallback(\n        (ref: HTMLDivElement | null) => {\n            if (ref === null) {\n                return;\n            }\n\n            calculateFadeFromElement(ref);\n            addEventListenerToElement(ref);\n        },\n        [addEventListenerToElement, calculateFadeFromElement]\n    );\n\n    const horizontalScrollFadeProps = useMemo(\n        () => ({\n            ref,\n            shouldShowLeftFade,\n            shouldShowRightFade,\n        }),\n        [shouldShowLeftFade, shouldShowRightFade, ref]\n    );\n\n    return horizontalScrollFadeProps;\n};\n"],"mappings":";;AAEA,MAAM,uBAAuB;AAE7B,MAAa,gCAAgC,SAAiB,MAAM;CAChE,MAAM,CAAC,oBAAoB,yBAAyB,SAAS,KAAK;CAClE,MAAM,CAAC,qBAAqB,0BAA0B,SAAS,KAAK;CAEpE,MAAM,2BAA2B,aAC5B,SAAsB;EACnB,MAAM,kBAAkB,KAAK;EAC7B,MAAM,mBAAmB,KAAK,cAAc,KAAK,aAAa,KAAK;EACnE,sBAAsB,kBAAkB,uBAAuB,MAAM;EACrE,uBAAuB,mBAAmB,uBAAuB,MAAM;CAC3E,GACA,CAAC,MAAM,CACX;CAEA,MAAM,4BAA4B,aAC7B,SAAsB;EACnB,KAAK,iBAAiB,WAAW,UAAU;GACvC,MAAM,OAAO,MAAM;GAEnB,IAAI,CAAC,MACD;GAGJ,yBAAyB,IAAI;EACjC,CAAC;CACL,GACA,CAAC,wBAAwB,CAC7B;CAEA,MAAM,MAAM,aACP,QAA+B;EAC5B,IAAI,QAAQ,MACR;EAGJ,yBAAyB,GAAG;EAC5B,0BAA0B,GAAG;CACjC,GACA,CAAC,2BAA2B,wBAAwB,CACxD;CAWA,OATkC,eACvB;EACH;EACA;EACA;CACJ,IACA;EAAC;EAAoB;EAAqB;CAAG,CAGlB;AACnC"}

package/horizontalScrollFadeMixin-ChYR-9hE.cjs

@@ -0,0 +1,43 @@
+let react = require("react");
+//#region src/mixins/horizontalScrollFadeMixin.ts
+const SHADOW_SCROLL_OFFSET = 5;
+const useHorizontalScrollFadeMixin = (offset = 8) => {
+	const [shouldShowLeftFade, setShouldShowLeftFade] = (0, react.useState)(false);
+	const [shouldShowRightFade, setShouldShowRightFade] = (0, react.useState)(false);
+	const calculateFadeFromElement = (0, react.useCallback)((elem) => {
+		const remainingOnLeft = elem.scrollLeft;
+		const remainingOnRight = elem.scrollWidth - elem.scrollLeft - elem.clientWidth;
+		setShouldShowLeftFade(remainingOnLeft - SHADOW_SCROLL_OFFSET > offset);
+		setShouldShowRightFade(remainingOnRight - SHADOW_SCROLL_OFFSET > offset);
+	}, [offset]);
+	const addEventListenerToElement = (0, react.useCallback)((elem) => {
+		elem.addEventListener("scroll", (event) => {
+			const elem = event.currentTarget;
+			if (!elem) return;
+			calculateFadeFromElement(elem);
+		});
+	}, [calculateFadeFromElement]);
+	const ref = (0, react.useCallback)((ref) => {
+		if (ref === null) return;
+		calculateFadeFromElement(ref);
+		addEventListenerToElement(ref);
+	}, [addEventListenerToElement, calculateFadeFromElement]);
+	return (0, react.useMemo)(() => ({
+		ref,
+		shouldShowLeftFade,
+		shouldShowRightFade
+	}), [
+		shouldShowLeftFade,
+		shouldShowRightFade,
+		ref
+	]);
+};
+//#endregion
+Object.defineProperty(exports, "useHorizontalScrollFadeMixin", {
+	enumerable: true,
+	get: function() {
+		return useHorizontalScrollFadeMixin;
+	}
+});
+
+//# sourceMappingURL=horizontalScrollFadeMixin-ChYR-9hE.cjs.map

package/horizontalScrollFadeMixin-ChYR-9hE.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"horizontalScrollFadeMixin-ChYR-9hE.cjs","names":[],"sources":["../src/mixins/horizontalScrollFadeMixin.ts"],"sourcesContent":["import { useCallback, useMemo, useState } from 'react';\n\nconst SHADOW_SCROLL_OFFSET = 5;\n\nexport const useHorizontalScrollFadeMixin = (offset: number = 8) => {\n    const [shouldShowLeftFade, setShouldShowLeftFade] = useState(false);\n    const [shouldShowRightFade, setShouldShowRightFade] = useState(false);\n\n    const calculateFadeFromElement = useCallback(\n        (elem: HTMLElement) => {\n            const remainingOnLeft = elem.scrollLeft;\n            const remainingOnRight = elem.scrollWidth - elem.scrollLeft - elem.clientWidth;\n            setShouldShowLeftFade(remainingOnLeft - SHADOW_SCROLL_OFFSET > offset);\n            setShouldShowRightFade(remainingOnRight - SHADOW_SCROLL_OFFSET > offset);\n        },\n        [offset]\n    );\n\n    const addEventListenerToElement = useCallback(\n        (elem: HTMLElement) => {\n            elem.addEventListener('scroll', (event) => {\n                const elem = event.currentTarget as HTMLDivElement | null;\n\n                if (!elem) {\n                    return;\n                }\n\n                calculateFadeFromElement(elem);\n            });\n        },\n        [calculateFadeFromElement]\n    );\n\n    const ref = useCallback(\n        (ref: HTMLDivElement | null) => {\n            if (ref === null) {\n                return;\n            }\n\n            calculateFadeFromElement(ref);\n            addEventListenerToElement(ref);\n        },\n        [addEventListenerToElement, calculateFadeFromElement]\n    );\n\n    const horizontalScrollFadeProps = useMemo(\n        () => ({\n            ref,\n            shouldShowLeftFade,\n            shouldShowRightFade,\n        }),\n        [shouldShowLeftFade, shouldShowRightFade, ref]\n    );\n\n    return horizontalScrollFadeProps;\n};\n"],"mappings":";;AAEA,MAAM,uBAAuB;AAE7B,MAAa,gCAAgC,SAAiB,MAAM;CAChE,MAAM,CAAC,oBAAoB,0BAAA,GAAA,MAAA,SAAA,CAAkC,KAAK;CAClE,MAAM,CAAC,qBAAqB,2BAAA,GAAA,MAAA,SAAA,CAAmC,KAAK;CAEpE,MAAM,4BAAA,GAAA,MAAA,YAAA,EACD,SAAsB;EACnB,MAAM,kBAAkB,KAAK;EAC7B,MAAM,mBAAmB,KAAK,cAAc,KAAK,aAAa,KAAK;EACnE,sBAAsB,kBAAkB,uBAAuB,MAAM;EACrE,uBAAuB,mBAAmB,uBAAuB,MAAM;CAC3E,GACA,CAAC,MAAM,CACX;CAEA,MAAM,6BAAA,GAAA,MAAA,YAAA,EACD,SAAsB;EACnB,KAAK,iBAAiB,WAAW,UAAU;GACvC,MAAM,OAAO,MAAM;GAEnB,IAAI,CAAC,MACD;GAGJ,yBAAyB,IAAI;EACjC,CAAC;CACL,GACA,CAAC,wBAAwB,CAC7B;CAEA,MAAM,OAAA,GAAA,MAAA,YAAA,EACD,QAA+B;EAC5B,IAAI,QAAQ,MACR;EAGJ,yBAAyB,GAAG;EAC5B,0BAA0B,GAAG;CACjC,GACA,CAAC,2BAA2B,wBAAwB,CACxD;CAWA,QAAA,GAAA,MAAA,QAAA,QARW;EACH;EACA;EACA;CACJ,IACA;EAAC;EAAoB;EAAqB;CAAG,CAGlB;AACnC"}

package/imageCluster.cjs

@@ -0,0 +1,54 @@
+'use client';
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_Icons = require("./Icons.cjs");
+let _evolve_ui_theme_system = require("@evolve.ui/theme-system");
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+//#region src/ImageCluster/ImageCluster.tsx
+const MAX_IMAGES = 3;
+const ImageCluster = ({ images, size }) => {
+	const [erroredIndexes, setErroredIndexes] = (0, react.useState)(/* @__PURE__ */ new Set());
+	const imagesToUse = (0, react.useMemo)(() => {
+		if (images.length > MAX_IMAGES) return images.slice(0, MAX_IMAGES);
+		return images;
+	}, [images]);
+	const handleImageError = (0, react.useCallback)((index) => {
+		setErroredIndexes((prev) => new Set(prev).add(index));
+	}, []);
+	const numberOfImages = imagesToUse.length;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		className: "relative flex h-[268px] justify-center smMax:h-[173px]",
+		children: imagesToUse.map((image, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			className: (0, _evolve_ui_theme_system.cn)("absolute flex h-[180px] w-[180px] items-center justify-center overflow-hidden rounded-md border-4 border-border-inverse shadow-02", erroredIndexes.has(index) ? "bg-background-subdued" : "bg-surface-50", { "top-[58px] -translate-x-[160px] -rotate-[15deg] smMax:top-[38px] smMax:h-[128px] smMax:w-[128px] smMax:-translate-x-[120px] smMax:-rotate-[15deg]": index === 0 && numberOfImages === 3 }, { "top-[38px] h-[128px] w-[128px] -translate-x-[120px] -rotate-[15deg]": numberOfImages === 3 && index === 0 && size === "sm" }, { "z-[1] h-[256px] w-[256px] smMax:h-[173px] smMax:w-[173px]": index === 1 && numberOfImages === 3 }, { "z-[1] h-[173px] w-[173px]": index === 1 && numberOfImages === 3 && size === "sm" }, { "top-[58px] translate-x-[160px] rotate-[15deg] smMax:top-[38px] smMax:h-[128px] smMax:w-[128px] smMax:translate-x-[120px] smMax:rotate-[15deg]": index === 2 && numberOfImages === 3 }, { "top-[38px] h-[128px] w-[128px] translate-x-[120px] rotate-[15deg]": index === 2 && numberOfImages === 3 && size === "sm" }, { "relative h-[256px] w-[256px] smMax:h-[173px] smMax:w-[173px]": numberOfImages === 2 || numberOfImages === 1 }, {
+				"smMax:translate-x-[10px] smMax:-rotate-[15deg]": index === 0 && numberOfImages === 2,
+				"translate-x-[20px] -rotate-[15deg]": index === 0 && numberOfImages === 2
+			}, {
+				"-translate-x-[20px] rotate-[15deg]": index === 1 && numberOfImages === 2,
+				"smMax:-translate-x-[10px] smMax:rotate-[15deg]": index === 1 && numberOfImages === 2
+			}),
+			children: erroredIndexes.has(index) ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Icons.ImageSquare, {
+				$withoutAriaLabel: true,
+				"aria-label": image.alt,
+				className: "m-auto",
+				color: "primary",
+				size: "lg",
+				style: "duotone"
+			}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("img", {
+				alt: image.alt,
+				className: "h-full w-full object-cover object-top",
+				height: 256,
+				loading: "lazy",
+				onError: () => handleImageError(index),
+				src: image.url,
+				width: 256
+			})
+		}, image.url))
+	});
+};
+//#endregion
+exports.ImageCluster = ImageCluster;
+
+//# sourceMappingURL=imageCluster.cjs.map

package/imageCluster.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageCluster.cjs","names":["ImageSquare"],"sources":["../src/ImageCluster/ImageCluster.tsx"],"sourcesContent":["import { cn } from '@evolve.ui/theme-system';\nimport { useCallback, useMemo, useState } from 'react';\n\nimport { ImageSquare } from '../Icons';\n\nconst MAX_IMAGES = 3;\n\ntype Props = {\n    /**\n     * The images to display in the cluster. Only the first three images are used; any additional\n     * images are silently ignored.\n     *\n     * When three images are provided, the slot order is:\n     * - `images[0]` → left card (tilted left, rendered behind the center)\n     * - `images[1]` → center card (front-most, largest)\n     * - `images[2]` → right card (tilted right, rendered behind the center)\n     */\n    images: {\n        alt: string;\n        url: string;\n    }[];\n    size: 'sm' | 'md';\n};\n\nexport const ImageCluster = ({ images, size }: Props) => {\n    const [erroredIndexes, setErroredIndexes] = useState<Set<number>>(new Set());\n\n    const imagesToUse = useMemo(() => {\n        if (images.length > MAX_IMAGES) {\n            return images.slice(0, MAX_IMAGES);\n        }\n        return images;\n    }, [images]);\n\n    const handleImageError = useCallback((index: number) => {\n        setErroredIndexes((prev) => new Set(prev).add(index));\n    }, []);\n\n    const numberOfImages = imagesToUse.length;\n\n    return (\n        <div className=\"relative flex h-[268px] justify-center smMax:h-[173px]\">\n            {imagesToUse.map((image, index) => (\n                <div\n                    className={cn(\n                        // BASE IMAGE CONTAINER CLASSES\n                        'absolute flex h-[180px] w-[180px] items-center justify-center overflow-hidden rounded-md border-4 border-border-inverse shadow-02',\n                        erroredIndexes.has(index) ? 'bg-background-subdued' : 'bg-surface-50',\n                        // POSITIONING WITH 3 IMAGES\n                        // IMAGE 1\n                        {\n                            'top-[58px] -translate-x-[160px] -rotate-[15deg] smMax:top-[38px] smMax:h-[128px] smMax:w-[128px] smMax:-translate-x-[120px] smMax:-rotate-[15deg]':\n                                index === 0 && numberOfImages === 3,\n                        },\n                        // IMAGE 1 SMALL\n                        {\n                            'top-[38px] h-[128px] w-[128px] -translate-x-[120px] -rotate-[15deg]':\n                                numberOfImages === 3 && index === 0 && size === 'sm',\n                        },\n\n                        // IMAGE 2\n                        {\n                            'z-[1] h-[256px] w-[256px] smMax:h-[173px] smMax:w-[173px]':\n                                index === 1 && numberOfImages === 3,\n                        },\n                        // IMAGE 2 SMALL\n                        {\n                            'z-[1] h-[173px] w-[173px]': index === 1 && numberOfImages === 3 && size === 'sm',\n                        },\n                        // IMAGE 3\n                        {\n                            'top-[58px] translate-x-[160px] rotate-[15deg] smMax:top-[38px] smMax:h-[128px] smMax:w-[128px] smMax:translate-x-[120px] smMax:rotate-[15deg]':\n                                index === 2 && numberOfImages === 3,\n                        },\n                        // SMALL\n                        {\n                            'top-[38px] h-[128px] w-[128px] translate-x-[120px] rotate-[15deg]':\n                                index === 2 && numberOfImages === 3 && size === 'sm',\n                        },\n                        // POSITIONING WITH 2 IMAGES\n                        {\n                            'relative h-[256px] w-[256px] smMax:h-[173px] smMax:w-[173px]':\n                                numberOfImages === 2 || numberOfImages === 1,\n                        },\n                        {\n                            // MOBILE\n                            'smMax:translate-x-[10px] smMax:-rotate-[15deg]': index === 0 && numberOfImages === 2,\n                            // DESKTOP\n                            'translate-x-[20px] -rotate-[15deg]': index === 0 && numberOfImages === 2,\n                        },\n                        {\n                            // DESKTOP\n                            '-translate-x-[20px] rotate-[15deg]': index === 1 && numberOfImages === 2,\n                            // MOBILE\n                            'smMax:-translate-x-[10px] smMax:rotate-[15deg]': index === 1 && numberOfImages === 2,\n                        }\n                        // With 1 image, we just keep the image in the center\n                    )}\n                    key={image.url}\n                >\n                    {erroredIndexes.has(index) ? (\n                        <ImageSquare\n                            $withoutAriaLabel\n                            aria-label={image.alt}\n                            className=\"m-auto\"\n                            color=\"primary\"\n                            size=\"lg\"\n                            style=\"duotone\"\n                        />\n                    ) : (\n                        <img\n                            alt={image.alt}\n                            className=\"h-full w-full object-cover object-top\"\n                            height={256}\n                            loading=\"lazy\"\n                            onError={() => handleImageError(index)}\n                            src={image.url}\n                            width={256}\n                        />\n                    )}\n                </div>\n            ))}\n        </div>\n    );\n};\n"],"mappings":";;;;;;;;;AAKA,MAAM,aAAa;AAmBnB,MAAa,gBAAgB,EAAE,QAAQ,WAAkB;CACrD,MAAM,CAAC,gBAAgB,sBAAA,GAAA,MAAA,SAAA,iBAA2C,IAAI,IAAI,CAAC;CAE3E,MAAM,eAAA,GAAA,MAAA,QAAA,OAA4B;EAC9B,IAAI,OAAO,SAAS,YAChB,OAAO,OAAO,MAAM,GAAG,UAAU;EAErC,OAAO;CACX,GAAG,CAAC,MAAM,CAAC;CAEX,MAAM,oBAAA,GAAA,MAAA,YAAA,EAAgC,UAAkB;EACpD,mBAAmB,SAAS,IAAI,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;CACxD,GAAG,CAAC,CAAC;CAEL,MAAM,iBAAiB,YAAY;CAEnC,OACI,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;EAAK,WAAU;YACV,YAAY,KAAK,OAAO,UACrB,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;GACI,YAAA,GAAA,wBAAA,GAAA,CAEI,qIACA,eAAe,IAAI,KAAK,IAAI,0BAA0B,iBAGtD,EACI,qJACI,UAAU,KAAK,mBAAmB,EAC1C,GAEA,EACI,uEACI,mBAAmB,KAAK,UAAU,KAAK,SAAS,KACxD,GAGA,EACI,6DACI,UAAU,KAAK,mBAAmB,EAC1C,GAEA,EACI,6BAA6B,UAAU,KAAK,mBAAmB,KAAK,SAAS,KACjF,GAEA,EACI,iJACI,UAAU,KAAK,mBAAmB,EAC1C,GAEA,EACI,qEACI,UAAU,KAAK,mBAAmB,KAAK,SAAS,KACxD,GAEA,EACI,gEACI,mBAAmB,KAAK,mBAAmB,EACnD,GACA;IAEI,kDAAkD,UAAU,KAAK,mBAAmB;IAEpF,sCAAsC,UAAU,KAAK,mBAAmB;GAC5E,GACA;IAEI,sCAAsC,UAAU,KAAK,mBAAmB;IAExE,kDAAkD,UAAU,KAAK,mBAAmB;GACxF,CAEJ;aAGC,eAAe,IAAI,KAAK,IACrB,iBAAA,GAAA,kBAAA,IAAA,CAACA,cAAAA,aAAD;IACI,mBAAA;IACA,cAAY,MAAM;IAClB,WAAU;IACV,OAAM;IACN,MAAK;IACL,OAAM;GACT,CAAA,IAED,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;IACI,KAAK,MAAM;IACX,WAAU;IACV,QAAQ;IACR,SAAQ;IACR,eAAe,iBAAiB,KAAK;IACrC,KAAK,MAAM;IACX,OAAO;GACV,CAAA;EAEJ,GAtBI,MAAM,GAsBV,CACR;CACA,CAAA;AAEb"}

package/imageCluster.d.cts

@@ -0,0 +1,2 @@
+import { t as ImageCluster } from "./ImageCluster-BXaQi8SB.cjs";
+export { ImageCluster };

package/imageCluster.d.mts

@@ -0,0 +1,2 @@
+import { t as ImageCluster } from "./ImageCluster-BXaQi8SB.mjs";
+export { ImageCluster };

package/imageCluster.mjs

@@ -0,0 +1,50 @@
+'use client';
+import { ImageSquare } from "./Icons.mjs";
+import { cn } from "@evolve.ui/theme-system";
+import { useCallback, useMemo, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/ImageCluster/ImageCluster.tsx
+const MAX_IMAGES = 3;
+const ImageCluster = ({ images, size }) => {
+	const [erroredIndexes, setErroredIndexes] = useState(/* @__PURE__ */ new Set());
+	const imagesToUse = useMemo(() => {
+		if (images.length > MAX_IMAGES) return images.slice(0, MAX_IMAGES);
+		return images;
+	}, [images]);
+	const handleImageError = useCallback((index) => {
+		setErroredIndexes((prev) => new Set(prev).add(index));
+	}, []);
+	const numberOfImages = imagesToUse.length;
+	return /* @__PURE__ */ jsx("div", {
+		className: "relative flex h-[268px] justify-center smMax:h-[173px]",
+		children: imagesToUse.map((image, index) => /* @__PURE__ */ jsx("div", {
+			className: cn("absolute flex h-[180px] w-[180px] items-center justify-center overflow-hidden rounded-md border-4 border-border-inverse shadow-02", erroredIndexes.has(index) ? "bg-background-subdued" : "bg-surface-50", { "top-[58px] -translate-x-[160px] -rotate-[15deg] smMax:top-[38px] smMax:h-[128px] smMax:w-[128px] smMax:-translate-x-[120px] smMax:-rotate-[15deg]": index === 0 && numberOfImages === 3 }, { "top-[38px] h-[128px] w-[128px] -translate-x-[120px] -rotate-[15deg]": numberOfImages === 3 && index === 0 && size === "sm" }, { "z-[1] h-[256px] w-[256px] smMax:h-[173px] smMax:w-[173px]": index === 1 && numberOfImages === 3 }, { "z-[1] h-[173px] w-[173px]": index === 1 && numberOfImages === 3 && size === "sm" }, { "top-[58px] translate-x-[160px] rotate-[15deg] smMax:top-[38px] smMax:h-[128px] smMax:w-[128px] smMax:translate-x-[120px] smMax:rotate-[15deg]": index === 2 && numberOfImages === 3 }, { "top-[38px] h-[128px] w-[128px] translate-x-[120px] rotate-[15deg]": index === 2 && numberOfImages === 3 && size === "sm" }, { "relative h-[256px] w-[256px] smMax:h-[173px] smMax:w-[173px]": numberOfImages === 2 || numberOfImages === 1 }, {
+				"smMax:translate-x-[10px] smMax:-rotate-[15deg]": index === 0 && numberOfImages === 2,
+				"translate-x-[20px] -rotate-[15deg]": index === 0 && numberOfImages === 2
+			}, {
+				"-translate-x-[20px] rotate-[15deg]": index === 1 && numberOfImages === 2,
+				"smMax:-translate-x-[10px] smMax:rotate-[15deg]": index === 1 && numberOfImages === 2
+			}),
+			children: erroredIndexes.has(index) ? /* @__PURE__ */ jsx(ImageSquare, {
+				$withoutAriaLabel: true,
+				"aria-label": image.alt,
+				className: "m-auto",
+				color: "primary",
+				size: "lg",
+				style: "duotone"
+			}) : /* @__PURE__ */ jsx("img", {
+				alt: image.alt,
+				className: "h-full w-full object-cover object-top",
+				height: 256,
+				loading: "lazy",
+				onError: () => handleImageError(index),
+				src: image.url,
+				width: 256
+			})
+		}, image.url))
+	});
+};
+//#endregion
+export { ImageCluster };
+
+//# sourceMappingURL=imageCluster.mjs.map

package/imageCluster.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageCluster.mjs","names":[],"sources":["../src/ImageCluster/ImageCluster.tsx"],"sourcesContent":["import { cn } from '@evolve.ui/theme-system';\nimport { useCallback, useMemo, useState } from 'react';\n\nimport { ImageSquare } from '../Icons';\n\nconst MAX_IMAGES = 3;\n\ntype Props = {\n    /**\n     * The images to display in the cluster. Only the first three images are used; any additional\n     * images are silently ignored.\n     *\n     * When three images are provided, the slot order is:\n     * - `images[0]` → left card (tilted left, rendered behind the center)\n     * - `images[1]` → center card (front-most, largest)\n     * - `images[2]` → right card (tilted right, rendered behind the center)\n     */\n    images: {\n        alt: string;\n        url: string;\n    }[];\n    size: 'sm' | 'md';\n};\n\nexport const ImageCluster = ({ images, size }: Props) => {\n    const [erroredIndexes, setErroredIndexes] = useState<Set<number>>(new Set());\n\n    const imagesToUse = useMemo(() => {\n        if (images.length > MAX_IMAGES) {\n            return images.slice(0, MAX_IMAGES);\n        }\n        return images;\n    }, [images]);\n\n    const handleImageError = useCallback((index: number) => {\n        setErroredIndexes((prev) => new Set(prev).add(index));\n    }, []);\n\n    const numberOfImages = imagesToUse.length;\n\n    return (\n        <div className=\"relative flex h-[268px] justify-center smMax:h-[173px]\">\n            {imagesToUse.map((image, index) => (\n                <div\n                    className={cn(\n                        // BASE IMAGE CONTAINER CLASSES\n                        'absolute flex h-[180px] w-[180px] items-center justify-center overflow-hidden rounded-md border-4 border-border-inverse shadow-02',\n                        erroredIndexes.has(index) ? 'bg-background-subdued' : 'bg-surface-50',\n                        // POSITIONING WITH 3 IMAGES\n                        // IMAGE 1\n                        {\n                            'top-[58px] -translate-x-[160px] -rotate-[15deg] smMax:top-[38px] smMax:h-[128px] smMax:w-[128px] smMax:-translate-x-[120px] smMax:-rotate-[15deg]':\n                                index === 0 && numberOfImages === 3,\n                        },\n                        // IMAGE 1 SMALL\n                        {\n                            'top-[38px] h-[128px] w-[128px] -translate-x-[120px] -rotate-[15deg]':\n                                numberOfImages === 3 && index === 0 && size === 'sm',\n                        },\n\n                        // IMAGE 2\n                        {\n                            'z-[1] h-[256px] w-[256px] smMax:h-[173px] smMax:w-[173px]':\n                                index === 1 && numberOfImages === 3,\n                        },\n                        // IMAGE 2 SMALL\n                        {\n                            'z-[1] h-[173px] w-[173px]': index === 1 && numberOfImages === 3 && size === 'sm',\n                        },\n                        // IMAGE 3\n                        {\n                            'top-[58px] translate-x-[160px] rotate-[15deg] smMax:top-[38px] smMax:h-[128px] smMax:w-[128px] smMax:translate-x-[120px] smMax:rotate-[15deg]':\n                                index === 2 && numberOfImages === 3,\n                        },\n                        // SMALL\n                        {\n                            'top-[38px] h-[128px] w-[128px] translate-x-[120px] rotate-[15deg]':\n                                index === 2 && numberOfImages === 3 && size === 'sm',\n                        },\n                        // POSITIONING WITH 2 IMAGES\n                        {\n                            'relative h-[256px] w-[256px] smMax:h-[173px] smMax:w-[173px]':\n                                numberOfImages === 2 || numberOfImages === 1,\n                        },\n                        {\n                            // MOBILE\n                            'smMax:translate-x-[10px] smMax:-rotate-[15deg]': index === 0 && numberOfImages === 2,\n                            // DESKTOP\n                            'translate-x-[20px] -rotate-[15deg]': index === 0 && numberOfImages === 2,\n                        },\n                        {\n                            // DESKTOP\n                            '-translate-x-[20px] rotate-[15deg]': index === 1 && numberOfImages === 2,\n                            // MOBILE\n                            'smMax:-translate-x-[10px] smMax:rotate-[15deg]': index === 1 && numberOfImages === 2,\n                        }\n                        // With 1 image, we just keep the image in the center\n                    )}\n                    key={image.url}\n                >\n                    {erroredIndexes.has(index) ? (\n                        <ImageSquare\n                            $withoutAriaLabel\n                            aria-label={image.alt}\n                            className=\"m-auto\"\n                            color=\"primary\"\n                            size=\"lg\"\n                            style=\"duotone\"\n                        />\n                    ) : (\n                        <img\n                            alt={image.alt}\n                            className=\"h-full w-full object-cover object-top\"\n                            height={256}\n                            loading=\"lazy\"\n                            onError={() => handleImageError(index)}\n                            src={image.url}\n                            width={256}\n                        />\n                    )}\n                </div>\n            ))}\n        </div>\n    );\n};\n"],"mappings":";;;;;AAKA,MAAM,aAAa;AAmBnB,MAAa,gBAAgB,EAAE,QAAQ,WAAkB;CACrD,MAAM,CAAC,gBAAgB,qBAAqB,yBAAsB,IAAI,IAAI,CAAC;CAE3E,MAAM,cAAc,cAAc;EAC9B,IAAI,OAAO,SAAS,YAChB,OAAO,OAAO,MAAM,GAAG,UAAU;EAErC,OAAO;CACX,GAAG,CAAC,MAAM,CAAC;CAEX,MAAM,mBAAmB,aAAa,UAAkB;EACpD,mBAAmB,SAAS,IAAI,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;CACxD,GAAG,CAAC,CAAC;CAEL,MAAM,iBAAiB,YAAY;CAEnC,OACI,oBAAC,OAAD;EAAK,WAAU;YACV,YAAY,KAAK,OAAO,UACrB,oBAAC,OAAD;GACI,WAAW,GAEP,qIACA,eAAe,IAAI,KAAK,IAAI,0BAA0B,iBAGtD,EACI,qJACI,UAAU,KAAK,mBAAmB,EAC1C,GAEA,EACI,uEACI,mBAAmB,KAAK,UAAU,KAAK,SAAS,KACxD,GAGA,EACI,6DACI,UAAU,KAAK,mBAAmB,EAC1C,GAEA,EACI,6BAA6B,UAAU,KAAK,mBAAmB,KAAK,SAAS,KACjF,GAEA,EACI,iJACI,UAAU,KAAK,mBAAmB,EAC1C,GAEA,EACI,qEACI,UAAU,KAAK,mBAAmB,KAAK,SAAS,KACxD,GAEA,EACI,gEACI,mBAAmB,KAAK,mBAAmB,EACnD,GACA;IAEI,kDAAkD,UAAU,KAAK,mBAAmB;IAEpF,sCAAsC,UAAU,KAAK,mBAAmB;GAC5E,GACA;IAEI,sCAAsC,UAAU,KAAK,mBAAmB;IAExE,kDAAkD,UAAU,KAAK,mBAAmB;GACxF,CAEJ;aAGC,eAAe,IAAI,KAAK,IACrB,oBAAC,aAAD;IACI,mBAAA;IACA,cAAY,MAAM;IAClB,WAAU;IACV,OAAM;IACN,MAAK;IACL,OAAM;GACT,CAAA,IAED,oBAAC,OAAD;IACI,KAAK,MAAM;IACX,WAAU;IACV,QAAQ;IACR,SAAQ;IACR,eAAe,iBAAiB,KAAK;IACrC,KAAK,MAAM;IACX,OAAO;GACV,CAAA;EAEJ,GAtBI,MAAM,GAsBV,CACR;CACA,CAAA;AAEb"}

package/imageSlider.cjs

@@ -0,0 +1,10 @@
+'use client';
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_ImageSlider = require("./ImageSlider-BidXfnLj.cjs");
+exports.CAROUSEL_CARD_GAP_NUM = require_ImageSlider.CAROUSEL_CARD_GAP_NUM;
+exports.ImageSlider = require_ImageSlider.ImageSlider;
+exports.ThumbnailDisplay = require_ImageSlider.ThumbnailDisplay;
+exports.Thumbnails = require_ImageSlider.Thumbnails;

package/imageSlider.d.cts

@@ -0,0 +1,2 @@
+import { a as ImageSliderCard, c as ResponsiveImageData, i as ImageSliderAnalyticsEvent, l as ThumbnailDisplay, n as ImageSlider, o as ImageSliderPageInfo, r as CAROUSEL_CARD_GAP_NUM, s as ResponsiveImageConfig, t as Thumbnails } from "./Thumbnails-B-eOrf55.cjs";
+export { CAROUSEL_CARD_GAP_NUM, ImageSlider, ImageSliderAnalyticsEvent, ImageSliderCard, ImageSliderPageInfo, ResponsiveImageConfig, ResponsiveImageData, ThumbnailDisplay, Thumbnails };

package/imageSlider.d.mts

@@ -0,0 +1,2 @@
+import { a as ImageSliderCard, c as ResponsiveImageData, i as ImageSliderAnalyticsEvent, l as ThumbnailDisplay, n as ImageSlider, o as ImageSliderPageInfo, r as CAROUSEL_CARD_GAP_NUM, s as ResponsiveImageConfig, t as Thumbnails } from "./Thumbnails-B-eOrf55.mjs";
+export { CAROUSEL_CARD_GAP_NUM, ImageSlider, ImageSliderAnalyticsEvent, ImageSliderCard, ImageSliderPageInfo, ResponsiveImageConfig, ResponsiveImageData, ThumbnailDisplay, Thumbnails };

package/imageSlider.mjs

@@ -0,0 +1,3 @@
+'use client';
+import { i as Thumbnails, n as CAROUSEL_CARD_GAP_NUM, r as ThumbnailDisplay, t as ImageSlider } from "./ImageSlider-CDrg_TbL.mjs";
+export { CAROUSEL_CARD_GAP_NUM, ImageSlider, ThumbnailDisplay, Thumbnails };

package/index-3V0Y3AU3.d.mts

@@ -0,0 +1,25 @@
+import { t as DateInput } from "./DateInput-CfNmywqQ.mjs";
+import { ComponentProps } from "react";
+import { PropsBase } from "react-day-picker";
+
+//#region src/DateTimeInput/datePicker/components/calendar/Calendar.d.ts
+type CalendarProps = {
+  onSelectDate?: (date: Date) => void;
+  selectedDate?: Date;
+} & Partial<Omit<PropsBase, 'styles' | 'style' | 'modifiersStyles' | 'components' | 'footer' | 'mode' | 'classNames'>>;
+declare const Calendar: ({
+  onSelectDate,
+  selectedDate,
+  ...rest
+}: CalendarProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/DateTimeInput/datePicker/DatePicker.d.ts
+type Props = {
+  calendarProps?: ComponentProps<typeof Calendar>;
+  closeOnSelect?: boolean;
+  zIndex?: number;
+} & ComponentProps<typeof DateInput>;
+declare const DatePicker: import("react").ForwardRefExoticComponent<Omit<Props, "ref"> & import("react").RefAttributes<HTMLInputElement>>;
+//#endregion
+export { DatePicker as t };
+//# sourceMappingURL=index-3V0Y3AU3.d.mts.map

package/index-3V0Y3AU3.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-3V0Y3AU3.d.mts","names":[],"sources":["../src/DateTimeInput/datePicker/components/calendar/Calendar.tsx","../src/DateTimeInput/datePicker/DatePicker.tsx"],"mappings":";;;;;KAQY,aAAA;EACR,YAAA,IAAgB,IAAA,EAAM,IAAA;EACtB,YAAA,GAAe,IAAA;AAAA,IACf,OAAA,CAAQ,IAAA,CAAK,SAAA;AAAA,cAEJ,QAAA;EAAY,YAAA;EAAA,YAAA;EAAA,GAAA;AAAA,GAAyC,aAAA,iCAAa,GAAA,CAAA,OAAA;;;KCS1E,KAAA;EACD,aAAA,GAAgB,cAAA,QAAsB,QAAA;EACtC,aAAA;EACA,MAAA;AAAA,IACA,cAAA,QAAsB,SAAA;AAAA,cAEb,UAAA,kBAAU,yBAAA,CAAA,IAAA,CAAA,KAAA,2BAAA,aAAA,CAAA,gBAAA"}

package/index-9649Aqry.d.cts

@@ -0,0 +1,84 @@
+import { HTMLProps, ReactNode } from "react";
+
+//#region src/JumpMenu/types/index.d.ts
+/**
+ * Base jump menu item data without handlers
+ */
+type JumpMenuItem = {
+  /** The href attribute for the link (for anchor navigation) - deprecated, use target */href?: string; /** Unique identifier for the menu item */
+  id: string; /** Whether this item is currently active/selected */
+  isActive?: boolean; /** The text or content to display in the menu item */
+  label: string | ReactNode; /** Click handler function that receives the item id */
+  onClick?: (id: string) => void; /** Target element selector (e.g., 'section1' for element with id='section1') */
+  target?: string;
+};
+//#endregion
+//#region src/JumpMenu/JumpMenu.d.ts
+/**
+ * Props for the JumpMenu component
+ */
+type Props = HTMLProps<HTMLElement> & {
+  /** Custom aria-label for the navigation (defaults to 'Jump to section') */ariaLabel?: string; /** Additional CSS classes for the menu container */
+  className?: string; /** CSS selector for the container element that defines the scope of fixed positioning behavior */
+  containerSelector?: string; /** Array of menu items to display in the jump navigation */
+  items: JumpMenuItem[]; /** Callback when active section changes via scroll or user interaction */
+  onActiveChange?: (activeId: string | null) => void; /** Additional CSS classes for the outer container of the menu */
+  outerContainerClassName?: string; /** Scroll offset in pixels to account for sticky headers when navigating to sections (defaults to 0) */
+  scrollOffset?: number; /** Scroll offset in pixels for mobile viewports (overrides scrollOffset on mobile, defaults to scrollOffset value) */
+  scrollOffsetMobile?: number;
+};
+/**
+ * JumpMenu component for horizontal scrollable navigation between page sections
+ *
+ * Features:
+ * - Horizontal scrolling with fade indicators on overflow
+ * - Automatic section highlighting based on scroll position
+ * - Keyboard navigation (Arrow keys, Home, End)
+ * - Smooth scrolling to target sections
+ * - Accessibility compliant with ARIA labels and roles
+ * - Fixed positioning with container visibility tracking
+ *
+ * @param ariaLabel - Custom aria-label for the navigation (defaults to 'Jump to section')
+ * @param className - Additional CSS classes for the menu container
+ * @param containerSelector - CSS selector for the container element that defines the scope of fixed positioning behavior
+ * @param items - Array of menu items to display - each item should have an id and either target or href
+ * @param onActiveChange - Callback when active section changes via scroll or user interaction
+ * @param outerContainerClassName - Additional CSS classes for the outer container of the menu
+ * @param scrollOffset - Scroll offset in pixels to account for sticky headers when navigating to sections (defaults to 0)
+ * @param scrollOffsetMobile - Scroll offset in pixels for mobile viewports (overrides scrollOffset on mobile, defaults to scrollOffset value)
+ *
+ *
+ * @example
+ * ```tsx
+ * const menuItems = [
+ *   { id: 'overview', label: 'Overview', href: '#overview-section' },
+ *   { id: 'details', label: 'Details', href: '#details-section' },
+ * ];
+ *
+ * <div id="container">
+ *  <JumpMenu
+ *   items={menuItems}
+ *   containerSelector="#container"
+ *   onActiveChange={(activeId) => console.log('Active section:', activeId)}
+ *   scrollOffset={80}        // Optional: Account for 80px sticky header
+ *   scrollOffsetMobile={120} // Optional: Account for larger mobile header
+ *  />
+ *  <section id="overview-section">Overview content</section>
+ *  <section id="details-section">Details content</section>
+ * </div>
+ * ```
+ */
+declare const JumpMenu: ({
+  ariaLabel,
+  className,
+  containerSelector,
+  items,
+  onActiveChange,
+  outerContainerClassName,
+  scrollOffset,
+  scrollOffsetMobile,
+  ...htmlProps
+}: Props) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { JumpMenuItem as n, JumpMenu as t };
+//# sourceMappingURL=index-9649Aqry.d.cts.map

package/index-9649Aqry.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-9649Aqry.d.cts","names":[],"sources":["../src/JumpMenu/types/index.ts","../src/JumpMenu/JumpMenu.tsx"],"mappings":";;;;;AAKA;KAAY,YAAA;yFAER,IAAA;EAEA,EAAA,UAEA;EAAA,QAAA,YAEgB;EAAhB,KAAA,WAAgB,SAAS,EAEd;EAAX,OAAA,IAAW,EAAA,mBAEL;EAAN,MAAA;AAAA;;;;AAZJ;;KCWK,KAAA,GAAQ,SAAA,CAAU,WAAA;EDHM,2ECKzB,SAAA,WDTA;ECWA,SAAA,WDPA;ECSA,iBAAA,WDPA;ECSA,KAAA,EAAO,YAAA,IDPP;ECSA,cAAA,IAAkB,QAAA,0BDTZ;ECWN,uBAAA;EAEA,YAAA,WAdC;EAgBD,kBAAA;AAAA;;;;;;;;;;;;;;;;;;;AAAkB;AA4CtB;;;;;;;;;;;;;;;;;;;;;;cAAa,QAAA;EAAY,SAAA;EAAA,SAAA;EAAA,iBAAA;EAAA,KAAA;EAAA,cAAA;EAAA,uBAAA;EAAA,YAAA;EAAA,kBAAA;EAAA,GAAA;AAAA,GAUtB,KAAA,iCAAK,GAAA,CAAA,OAAA"}