@evolve.ui/core-components 1.0.0

package/fileUpload/testUtils/testUtils.d.cts

@@ -0,0 +1,13 @@
+import { v as RemoteFile } from "../../index-BAR19_eg.cjs";
+
+//#region src/FileUpload/testUtils/testUtils.d.ts
+declare const getRandomImage: () => string;
+declare const createRemoteFileFromUrl: (url: string, index?: number) => RemoteFile;
+declare const createTestFile: (name: string, type: string, sizeInBytes?: number) => File;
+declare const shuffleArray: <T>(array: T[]) => T[];
+declare const createMockFiles: (count: number) => File[];
+declare const createMockRemoteFileImages: (count: number) => RemoteFile[];
+declare const createMixedFilesAndImageUrls: (fileCount: number, imageUrlCount: number) => (File | RemoteFile)[];
+//#endregion
+export { createMixedFilesAndImageUrls, createMockFiles, createMockRemoteFileImages, createRemoteFileFromUrl, createTestFile, getRandomImage, shuffleArray };
+//# sourceMappingURL=testUtils.d.cts.map

package/fileUpload/testUtils/testUtils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testUtils.d.cts","names":[],"sources":["../../../src/FileUpload/testUtils/testUtils.ts"],"mappings":";;;cAiCa,cAAA;AAAA,cAMA,uBAAA,GAA2B,GAAA,UAAa,KAAA,cAAiB,UAsBrE;AAAA,cAEY,cAAA,GAAkB,IAAA,UAAc,IAAA,UAAc,WAAA,cAAqB,IAiB/E;AAAA,cAGY,YAAA,MAAmB,KAAA,EAAO,CAAA,OAAM,CAAC;AAAA,cAUjC,eAAA,GAAmB,KAAA,aAAgB,IAAI;AAAA,cAMvC,0BAAA,GAA8B,KAAA,aAAgB,UAAU;AAAA,cAOxD,4BAAA,GAAgC,SAAA,UAAmB,aAAA,cAAqB,IAAA,GAAA,UAAA"}

package/fileUpload/testUtils/testUtils.d.mts

@@ -0,0 +1,13 @@
+import { v as RemoteFile } from "../../index-BAR19_eg.mjs";
+
+//#region src/FileUpload/testUtils/testUtils.d.ts
+declare const getRandomImage: () => string;
+declare const createRemoteFileFromUrl: (url: string, index?: number) => RemoteFile;
+declare const createTestFile: (name: string, type: string, sizeInBytes?: number) => File;
+declare const shuffleArray: <T>(array: T[]) => T[];
+declare const createMockFiles: (count: number) => File[];
+declare const createMockRemoteFileImages: (count: number) => RemoteFile[];
+declare const createMixedFilesAndImageUrls: (fileCount: number, imageUrlCount: number) => (File | RemoteFile)[];
+//#endregion
+export { createMixedFilesAndImageUrls, createMockFiles, createMockRemoteFileImages, createRemoteFileFromUrl, createTestFile, getRandomImage, shuffleArray };
+//# sourceMappingURL=testUtils.d.mts.map

package/fileUpload/testUtils/testUtils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testUtils.d.mts","names":[],"sources":["../../../src/FileUpload/testUtils/testUtils.ts"],"mappings":";;;cAiCa,cAAA;AAAA,cAMA,uBAAA,GAA2B,GAAA,UAAa,KAAA,cAAiB,UAsBrE;AAAA,cAEY,cAAA,GAAkB,IAAA,UAAc,IAAA,UAAc,WAAA,cAAqB,IAiB/E;AAAA,cAGY,YAAA,MAAmB,KAAA,EAAO,CAAA,OAAM,CAAC;AAAA,cAUjC,eAAA,GAAmB,KAAA,aAAgB,IAAI;AAAA,cAMvC,0BAAA,GAA8B,KAAA,aAAgB,UAAU;AAAA,cAOxD,4BAAA,GAAgC,SAAA,UAAmB,aAAA,cAAqB,IAAA,GAAA,UAAA"}

package/fileUpload/testUtils/testUtils.mjs

@@ -0,0 +1,81 @@
+'use client';
+//#region src/FileUpload/testUtils/testUtils.ts
+const availableImages = [
+	"/card/arne_wahl.jpg",
+	"/card/arne_wahl_2.png",
+	"/card/art_deco.jpg",
+	"/card/art_deco_2.png",
+	"/card/donghia.jpg",
+	"/card/donghia_2.png",
+	"/card/maximilian.jpg",
+	"/card/maximilian_2.png",
+	"/card/milo.jpg",
+	"/card/milo_2.png",
+	"/card/modern.png",
+	"/card/modern_2.png",
+	"/card/scalamandre.jpg",
+	"/card/scalamandre_2.png",
+	"/card/scandinavian.jpg",
+	"/card/scandinavian_2.png",
+	"/card/schriever.jpg",
+	"/card/schriever_2.png",
+	"/card/walnut_full.jpg",
+	"/card/walnut_full_2.png",
+	"/contrast-test-images/(neutral)-train-on-bridge.jpg",
+	"/contrast-test-images/ford-motor.webp",
+	"/contrast-test-images/(colorful)-flowers.jpg",
+	"/contrast-test-images/(dark)-deep-blue.jpg"
+];
+const getRandomImage = () => {
+	const randomIndex = Math.floor(Math.random() * availableImages.length);
+	return availableImages[randomIndex];
+};
+const createRemoteFileFromUrl = (url, index) => {
+	const urlPart = url.split("/").pop();
+	const filename = urlPart && urlPart.length > 0 ? urlPart : `image-${index ?? 0}`;
+	const extension = filename.split(".").pop()?.toLowerCase();
+	let type = "image/jpeg";
+	if (extension === "png") type = "image/png";
+	if (extension === "webp") type = "image/webp";
+	if (extension === "gif") type = "image/gif";
+	return {
+		name: filename,
+		type,
+		url
+	};
+};
+const createTestFile = (name, type, sizeInBytes = 1024) => {
+	const content = Array(Math.ceil(sizeInBytes / 10)).fill("test content").join("");
+	const file = new File([content], name, {
+		lastModified: Date.now(),
+		type
+	});
+	Object.defineProperty(file, "size", { value: sizeInBytes });
+	return file;
+};
+const shuffleArray = (array) => {
+	const shuffled = [...array];
+	for (let i = shuffled.length - 1; i > 0; i--) {
+		const j = Math.floor(Math.random() * (i + 1));
+		[shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];
+	}
+	return shuffled;
+};
+const createMockFiles = (count) => {
+	return Array.from({ length: count }, (_, index) => createTestFile(`file-${index}.pdf`, "application/pdf", 1024 * (index + 1)));
+};
+const createMockRemoteFileImages = (count) => {
+	return Array.from({ length: count }, (_, index) => {
+		const randomUrl = getRandomImage();
+		return createRemoteFileFromUrl(randomUrl, index);
+	});
+};
+const createMixedFilesAndImageUrls = (fileCount, imageUrlCount) => {
+	const files = createMockFiles(fileCount);
+	const imageUrls = createMockRemoteFileImages(imageUrlCount);
+	return [...files, ...imageUrls];
+};
+//#endregion
+export { createMixedFilesAndImageUrls, createMockFiles, createMockRemoteFileImages, createRemoteFileFromUrl, createTestFile, getRandomImage, shuffleArray };
+
+//# sourceMappingURL=testUtils.mjs.map

package/fileUpload/testUtils/testUtils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"testUtils.mjs","names":[],"sources":["../../../src/FileUpload/testUtils/testUtils.ts"],"sourcesContent":["import { RemoteFile } from '../types';\n\n// Array of all available image files in the card and contrast-test-images directories\nconst availableImages = [\n    // Card images\n    '/card/arne_wahl.jpg',\n    '/card/arne_wahl_2.png',\n    '/card/art_deco.jpg',\n    '/card/art_deco_2.png',\n    '/card/donghia.jpg',\n    '/card/donghia_2.png',\n    '/card/maximilian.jpg',\n    '/card/maximilian_2.png',\n    '/card/milo.jpg',\n    '/card/milo_2.png',\n    '/card/modern.png',\n    '/card/modern_2.png',\n    '/card/scalamandre.jpg',\n    '/card/scalamandre_2.png',\n    '/card/scandinavian.jpg',\n    '/card/scandinavian_2.png',\n    '/card/schriever.jpg',\n    '/card/schriever_2.png',\n    '/card/walnut_full.jpg',\n    '/card/walnut_full_2.png',\n    // Contrast test images\n    '/contrast-test-images/(neutral)-train-on-bridge.jpg',\n    '/contrast-test-images/ford-motor.webp',\n    '/contrast-test-images/(colorful)-flowers.jpg',\n    '/contrast-test-images/(dark)-deep-blue.jpg',\n];\n\n// Function to get a random image from the available images\nexport const getRandomImage = () => {\n    const randomIndex = Math.floor(Math.random() * availableImages.length);\n    return availableImages[randomIndex];\n};\n\n// Function to create a RemoteFile object from an image URL\nexport const createRemoteFileFromUrl = (url: string, index?: number): RemoteFile => {\n    const urlPart = url.split('/').pop();\n    const filename = urlPart && urlPart.length > 0 ? urlPart : `image-${index ?? 0}`;\n    const extension = filename.split('.').pop()?.toLowerCase();\n\n    // Determine MIME type based on extension\n    let type = 'image/jpeg'; // default\n    if (extension === 'png') {\n        type = 'image/png';\n    }\n    if (extension === 'webp') {\n        type = 'image/webp';\n    }\n    if (extension === 'gif') {\n        type = 'image/gif';\n    }\n\n    return {\n        name: filename,\n        type,\n        url,\n    };\n};\n\nexport const createTestFile = (name: string, type: string, sizeInBytes = 1024): File => {\n    // Create content with the specified size\n    const content = Array(Math.ceil(sizeInBytes / 10))\n        .fill('test content')\n        .join('');\n\n    // Create the File object with basic properties\n    const file = new File([content], name, {\n        lastModified: Date.now(),\n        type,\n    });\n\n    // Override the size property to match the requested size\n    // This is needed because the actual content might not match exactly\n    Object.defineProperty(file, 'size', { value: sizeInBytes });\n\n    return file;\n};\n\n// Shuffle an array using Fisher-Yates algorithm\nexport const shuffleArray = <T>(array: T[]): T[] => {\n    const shuffled = [...array];\n    for (let i = shuffled.length - 1; i > 0; i--) {\n        const j = Math.floor(Math.random() * (i + 1));\n        [shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];\n    }\n    return shuffled;\n};\n\n// Helper functions to create mock data\nexport const createMockFiles = (count: number): File[] => {\n    return Array.from({ length: count }, (_, index) =>\n        createTestFile(`file-${index}.pdf`, 'application/pdf', 1024 * (index + 1))\n    );\n};\n\nexport const createMockRemoteFileImages = (count: number): RemoteFile[] => {\n    return Array.from({ length: count }, (_, index) => {\n        const randomUrl = getRandomImage();\n        return createRemoteFileFromUrl(randomUrl, index);\n    });\n};\n\nexport const createMixedFilesAndImageUrls = (fileCount: number, imageUrlCount: number) => {\n    const files = createMockFiles(fileCount);\n    const imageUrls = createMockRemoteFileImages(imageUrlCount);\n    return [...files, ...imageUrls];\n};\n"],"mappings":";AAGA,MAAM,kBAAkB;CAEpB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;AACJ;AAGA,MAAa,uBAAuB;CAChC,MAAM,cAAc,KAAK,MAAM,KAAK,OAAO,IAAI,gBAAgB,MAAM;CACrE,OAAO,gBAAgB;AAC3B;AAGA,MAAa,2BAA2B,KAAa,UAA+B;CAChF,MAAM,UAAU,IAAI,MAAM,GAAG,CAAC,CAAC,IAAI;CACnC,MAAM,WAAW,WAAW,QAAQ,SAAS,IAAI,UAAU,SAAS,SAAS;CAC7E,MAAM,YAAY,SAAS,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,YAAY;CAGzD,IAAI,OAAO;CACX,IAAI,cAAc,OACd,OAAO;CAEX,IAAI,cAAc,QACd,OAAO;CAEX,IAAI,cAAc,OACd,OAAO;CAGX,OAAO;EACH,MAAM;EACN;EACA;CACJ;AACJ;AAEA,MAAa,kBAAkB,MAAc,MAAc,cAAc,SAAe;CAEpF,MAAM,UAAU,MAAM,KAAK,KAAK,cAAc,EAAE,CAAC,CAAC,CAC7C,KAAK,cAAc,CAAC,CACpB,KAAK,EAAE;CAGZ,MAAM,OAAO,IAAI,KAAK,CAAC,OAAO,GAAG,MAAM;EACnC,cAAc,KAAK,IAAI;EACvB;CACJ,CAAC;CAID,OAAO,eAAe,MAAM,QAAQ,EAAE,OAAO,YAAY,CAAC;CAE1D,OAAO;AACX;AAGA,MAAa,gBAAmB,UAAoB;CAChD,MAAM,WAAW,CAAC,GAAG,KAAK;CAC1B,KAAK,IAAI,IAAI,SAAS,SAAS,GAAG,IAAI,GAAG,KAAK;EAC1C,MAAM,IAAI,KAAK,MAAM,KAAK,OAAO,KAAK,IAAI,EAAE;EAC5C,CAAC,SAAS,IAAI,SAAS,MAAM,CAAC,SAAS,IAAI,SAAS,EAAE;CAC1D;CACA,OAAO;AACX;AAGA,MAAa,mBAAmB,UAA0B;CACtD,OAAO,MAAM,KAAK,EAAE,QAAQ,MAAM,IAAI,GAAG,UACrC,eAAe,QAAQ,MAAM,OAAO,mBAAmB,QAAQ,QAAQ,EAAE,CAC7E;AACJ;AAEA,MAAa,8BAA8B,UAAgC;CACvE,OAAO,MAAM,KAAK,EAAE,QAAQ,MAAM,IAAI,GAAG,UAAU;EAC/C,MAAM,YAAY,eAAe;EACjC,OAAO,wBAAwB,WAAW,KAAK;CACnD,CAAC;AACL;AAEA,MAAa,gCAAgC,WAAmB,kBAA0B;CACtF,MAAM,QAAQ,gBAAgB,SAAS;CACvC,MAAM,YAAY,2BAA2B,aAAa;CAC1D,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS;AAClC"}

package/fileUpload/types.cjs

@@ -0,0 +1,31 @@
+'use client';
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region src/FileUpload/types/commonTypes.ts
+/**
+* Type guard to check if a context is a drag context
+* Use this before accessing drag-specific properties
+*
+* @param context - The message context to check
+* @returns true if context is a drag context, false otherwise
+*/
+const isDragContext = (context) => {
+	return context.eventType === "drag";
+};
+/**
+* Type guard to check if a context is a drop context
+* Use this before accessing drop-specific properties
+*
+* @param context - The message context to check
+* @returns true if context is a drop context, false otherwise
+*/
+const isDropContext = (context) => {
+	return context.eventType === "drop";
+};
+//#endregion
+exports.isDragContext = isDragContext;
+exports.isDropContext = isDropContext;
+
+//# sourceMappingURL=types.cjs.map

package/fileUpload/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","names":[],"sources":["../../src/FileUpload/types/commonTypes.ts"],"sourcesContent":["import { type FileRejection as ReactDropzoneFileRejection } from 'react-dropzone';\n\n/**\n * Possible error codes for file validation failures - these are the codes that are used in the validation messages.\n * These are the codes used by React-Dropzone under the hood.\n * @typedef {string} FileErrorCode\n * @property {'file-invalid-type'} - File type not accepted\n * @property {'file-too-large'} - File exceeds size limit\n * @property {'too-many-files'} - Exceeds maximum file count\n * @property {string} CustomError - Custom error message\n */\nexport type FileErrorCode = 'file-invalid-type' | 'file-too-large' | 'too-many-files' | string;\n\nexport type RemoteFile = {\n    id?: string;\n    name: string;\n    type?: string;\n    url: string;\n};\n\n// FileResource is used to represent a file or a remote file\nexport type FileResource = File | RemoteFile;\n\n/**\n * Generic type for messages that can be either a string or a function that returns a string based on context\n * This allows for dynamic messages that can incorporate data from the current validation context.\n *\n * @template T - The context type that will be passed to the message function\n * @example\n * // Static message\n * const staticMessage: ContextAwareMessage<DynamicMessageContext> = \"File type not supported\";\n *\n * // Dynamic message that uses context\n * const dynamicMessage: ContextAwareMessage<DynamicMessageContext> =\n *   (context) => `File exceeds the ${context.formattedMaxSize} limit`;\n */\nexport type ContextAwareMessage<T> = string | ((context: T) => string) | undefined;\n\n/**\n * Base context with common properties used by all message types\n * Contains the shared information needed to generate validation messages\n * for both drag and drop events.\n *\n * @property acceptedFileExtensions - Comma-separated list of accepted file extensions (e.g., '.jpg, .png')\n * @property errorCode - The validation error code triggering this message\n * @property fileCount - Number of files involved in the validation event\n * @property filePluralizationText - Properly pluralized text for file type (e.g., \"image\" or \"images\")\n * @property formattedMaxSize - Human-readable maximum file size (e.g., \"5 MB\")\n * @property maxFiles - Maximum number of files allowed\n * @property maxFilesPluralizationText - Properly pluralized text for max files (e.g., \"file\" or \"files\")\n * @property maxSizeBytes - Maximum file size in bytes\n */\nexport type BaseDynamicMessageContext = {\n    acceptedFileExtensions?: string;\n    errorCode: string;\n    fileCount?: number;\n    filePluralizationText?: string;\n    formattedMaxSize?: string;\n    maxFiles?: number;\n    maxFilesPluralizationText?: string;\n    maxSizeBytes?: number;\n};\n\n/**\n * Context for drag events with drag-specific properties\n * Used to generate validation messages during file drag operations.\n *\n * @property draggedItems - The DataTransferItemList containing all items being dragged (not just rejected ones)\n * @property eventType - Always 'drag' for drag events\n */\nexport type DragMessageContext = BaseDynamicMessageContext & {\n    draggedItems?: DataTransferItemList;\n    eventType: 'drag';\n};\n\n/**\n * Context for drop events with drop-specific properties\n * Used to generate validation messages after files have been dropped.\n *\n * @property eventType - Always 'drop' for drop events\n * @property rejectedFileList - Comma-separated list of rejected file names\n * @property rejectedFiles - Array of File objects that failed validation\n */\nexport type DropMessageContext = BaseDynamicMessageContext & {\n    eventType: 'drop';\n    rejectedFileList?: string;\n    rejectedFiles?: File[];\n};\n\n/**\n * Guaranteed minimal properties available on all DynamicMessageContext variants.\n * This type represents the contract for what you can ALWAYS safely destructure\n * from any message context, regardless of whether it's a drag or drop event.\n *\n * Your custom validator message functions receive the full DynamicMessageContext,\n * but you can safely destructure just these core properties for simple validators.\n *\n * @property fileCount - Number of files involved in the validation\n * @property filePluralizationText - Properly pluralized text (e.g., \"file\" or \"files\")\n *\n * @example\n * // Simple validator - only uses guaranteed properties\n * const validator: FileValidator = (file) => {\n *   if (invalid) {\n *     return [{\n *       code: 'custom-error',\n *       message: ({ fileCount, filePluralizationText }) =>\n *         `${fileCount} ${filePluralizationText} failed validation`\n *     }];\n *   }\n *   return null;\n * };\n */\nexport type ValidationMessageContext = {\n    fileCount: number;\n    filePluralizationText: string;\n};\n\n/**\n * Context object provided to dynamic message functions in validators.\n * This is a union of drag and drop contexts, representing what's actually passed at runtime.\n *\n * While the full context includes many optional properties (like formattedMaxSize, maxFiles, etc.),\n * you can always safely destructure the core properties: fileCount and filePluralizationText\n * (see ValidationMessageContext for the guaranteed minimal subset).\n *\n * Use isDragContext or isDropContext type guards to access event-specific properties safely.\n */\nexport type DynamicMessageContext = DragMessageContext | DropMessageContext;\n\n/**\n * Type guard to check if a context is a drag context\n * Use this before accessing drag-specific properties\n *\n * @param context - The message context to check\n * @returns true if context is a drag context, false otherwise\n */\nexport const isDragContext = (context: DynamicMessageContext): context is DragMessageContext => {\n    return context.eventType === 'drag';\n};\n\n/**\n * Type guard to check if a context is a drop context\n * Use this before accessing drop-specific properties\n *\n * @param context - The message context to check\n * @returns true if context is a drop context, false otherwise\n */\nexport const isDropContext = (context: DynamicMessageContext): context is DropMessageContext => {\n    return context.eventType === 'drop';\n};\n\n/**\n * Parameters for generating validation messages\n * Used to create appropriate error messages for different validation scenarios.\n *\n * @property code - The error code that triggered the validation failure\n * @property count - Optional number of files that failed this specific validation\n * @property message - Optional message string or function that generates a message based on context\n * @property messageType - Optional string indicating the type of message ('drag' or 'drop')\n */\nexport type ValidationMessageParams = {\n    code: FileErrorCode;\n    count?: number;\n    message?: ContextAwareMessage<DynamicMessageContext>;\n    messageType?: 'drag' | 'drop';\n};\n\n/**\n * Represents a file validation error that can include dynamic messaging\n * Used during the validation process before messages are finalized.\n * This type allows for context-aware messages that can be resolved\n * at runtime based on the validation context.\n *\n * @property code - Error code identifying the type of validation failure\n * @property message - Human-readable error message or function that generates one\n * @remarks Used during validation process before messages are finalized\n */\nexport type DynamicFileError = {\n    code: FileErrorCode;\n    message: ContextAwareMessage<DynamicMessageContext>;\n};\n\n/**\n * Structure for processed validation error responses\n * The final form of validation errors after message resolution.\n * Unlike DynamicFileError, FileError messages are always strings,\n * as they have already been processed with context.\n *\n * @property code - Error code identifying the type of validation failure\n * @property message - Human-readable error message\n * @remarks Used for displaying validation results after message processing\n */\nexport type FileError = {\n    code: FileErrorCode;\n    message: string;\n};\n\n/**\n * Union type for validation errors that can be either a FileError or a DynamicFileError\n * This type allows for flexibility in handling different types of validation errors\n * and provides a common interface for processing them\n */\nexport type ValidationError = FileError | DynamicFileError;\n\n/**\n * Represents a file rejection from the upload process\n * Re-exported from react-dropzone for convenience\n *\n * @property file - The rejected file\n * @property errors - Array of errors associated with the rejected file\n */\nexport type FileRejection = ReactDropzoneFileRejection;\n\n/**\n * Predefined categories of file types\n * Used as a convenient shorthand for common file type groups\n *\n * @value 'images' - Common image formats (jpeg, png, gif, webp)\n * @value 'pdfs' - PDF documents only\n * @value 'documents' - Office and PDF documents (pdf, doc, docx, xls, xlsx)\n */\nexport type CommonFileTypes = 'images' | 'pdfs' | 'documents';\n\n/**\n * Ensures numbers are greater than 0; used for validation parameters\n * A type utility that prevents negative numbers or zero from being used\n * in places where only positive numbers make sense (e.g., file size limits)\n */\nexport type PositiveNumber = number extends infer N\n    ? N extends number\n        ? N extends 0\n            ? never\n            : N extends -1\n              ? never\n              : number\n        : never\n    : never;\n\n/**\n * Custom validation function for file uploads\n * Implement this to create custom validation rules beyond the built-in ones\n *\n * @param file - File or DataTransferItem to validate\n * @returns An array of ValidationError objects if validation fails, null if passes\n */\nexport type FileValidator = (file: File | DataTransferItem) => ValidationError[] | null;\n\n/**\n * Configuration for file validation\n * Used to set up validation rules and behavior for file uploads\n *\n * @property accept - Allowed file types (preset categories or MIME types/extensions)\n * @property error - Optional custom error to display regardless of validation results\n * @property maxFiles - Maximum number of files allowed\n * @property maxSize - Maximum file size in bytes\n * @property strictValidation - If true, rejects all files when any validation fails\n * @property validator - Optional custom validation function\n */\nexport type ValidationConfig = {\n    accept?: CommonFileTypes | string[];\n    error?: FileError;\n    maxFiles?: number;\n    maxSize?: number;\n    strictValidation?: boolean;\n    validator?: FileValidator;\n};\n"],"mappings":";;;;;;;;;;;;AAyIA,MAAa,iBAAiB,YAAkE;CAC5F,OAAO,QAAQ,cAAc;AACjC;;;;;;;;AASA,MAAa,iBAAiB,YAAkE;CAC5F,OAAO,QAAQ,cAAc;AACjC"}

package/fileUpload/types.d.cts

@@ -0,0 +1,2 @@
+import { C as isDropContext, S as isDragContext, _ as PositiveNumber, b as ValidationError, d as DynamicMessageContext, f as FileError, g as FileValidator, h as FileResource, m as FileRejection, n as FileUploadContextType, o as UploadValidationContextType, p as FileErrorCode, u as DynamicFileError, v as RemoteFile, x as ValidationMessageContext } from "../index-BAR19_eg.cjs";
+export { type DynamicFileError, type DynamicMessageContext, type FileError, type FileErrorCode, type FileRejection, type FileResource, type FileUploadContextType, type FileValidator, type PositiveNumber, type RemoteFile, type UploadValidationContextType, type ValidationError, type ValidationMessageContext, isDragContext, isDropContext };

package/fileUpload/types.d.mts

@@ -0,0 +1,2 @@
+import { C as isDropContext, S as isDragContext, _ as PositiveNumber, b as ValidationError, d as DynamicMessageContext, f as FileError, g as FileValidator, h as FileResource, m as FileRejection, n as FileUploadContextType, o as UploadValidationContextType, p as FileErrorCode, u as DynamicFileError, v as RemoteFile, x as ValidationMessageContext } from "../index-BAR19_eg.mjs";
+export { type DynamicFileError, type DynamicMessageContext, type FileError, type FileErrorCode, type FileRejection, type FileResource, type FileUploadContextType, type FileValidator, type PositiveNumber, type RemoteFile, type UploadValidationContextType, type ValidationError, type ValidationMessageContext, isDragContext, isDropContext };

package/fileUpload/types.mjs

@@ -0,0 +1,26 @@
+'use client';
+//#region src/FileUpload/types/commonTypes.ts
+/**
+* Type guard to check if a context is a drag context
+* Use this before accessing drag-specific properties
+*
+* @param context - The message context to check
+* @returns true if context is a drag context, false otherwise
+*/
+const isDragContext = (context) => {
+	return context.eventType === "drag";
+};
+/**
+* Type guard to check if a context is a drop context
+* Use this before accessing drop-specific properties
+*
+* @param context - The message context to check
+* @returns true if context is a drop context, false otherwise
+*/
+const isDropContext = (context) => {
+	return context.eventType === "drop";
+};
+//#endregion
+export { isDragContext, isDropContext };
+
+//# sourceMappingURL=types.mjs.map

package/fileUpload/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../../src/FileUpload/types/commonTypes.ts"],"sourcesContent":["import { type FileRejection as ReactDropzoneFileRejection } from 'react-dropzone';\n\n/**\n * Possible error codes for file validation failures - these are the codes that are used in the validation messages.\n * These are the codes used by React-Dropzone under the hood.\n * @typedef {string} FileErrorCode\n * @property {'file-invalid-type'} - File type not accepted\n * @property {'file-too-large'} - File exceeds size limit\n * @property {'too-many-files'} - Exceeds maximum file count\n * @property {string} CustomError - Custom error message\n */\nexport type FileErrorCode = 'file-invalid-type' | 'file-too-large' | 'too-many-files' | string;\n\nexport type RemoteFile = {\n    id?: string;\n    name: string;\n    type?: string;\n    url: string;\n};\n\n// FileResource is used to represent a file or a remote file\nexport type FileResource = File | RemoteFile;\n\n/**\n * Generic type for messages that can be either a string or a function that returns a string based on context\n * This allows for dynamic messages that can incorporate data from the current validation context.\n *\n * @template T - The context type that will be passed to the message function\n * @example\n * // Static message\n * const staticMessage: ContextAwareMessage<DynamicMessageContext> = \"File type not supported\";\n *\n * // Dynamic message that uses context\n * const dynamicMessage: ContextAwareMessage<DynamicMessageContext> =\n *   (context) => `File exceeds the ${context.formattedMaxSize} limit`;\n */\nexport type ContextAwareMessage<T> = string | ((context: T) => string) | undefined;\n\n/**\n * Base context with common properties used by all message types\n * Contains the shared information needed to generate validation messages\n * for both drag and drop events.\n *\n * @property acceptedFileExtensions - Comma-separated list of accepted file extensions (e.g., '.jpg, .png')\n * @property errorCode - The validation error code triggering this message\n * @property fileCount - Number of files involved in the validation event\n * @property filePluralizationText - Properly pluralized text for file type (e.g., \"image\" or \"images\")\n * @property formattedMaxSize - Human-readable maximum file size (e.g., \"5 MB\")\n * @property maxFiles - Maximum number of files allowed\n * @property maxFilesPluralizationText - Properly pluralized text for max files (e.g., \"file\" or \"files\")\n * @property maxSizeBytes - Maximum file size in bytes\n */\nexport type BaseDynamicMessageContext = {\n    acceptedFileExtensions?: string;\n    errorCode: string;\n    fileCount?: number;\n    filePluralizationText?: string;\n    formattedMaxSize?: string;\n    maxFiles?: number;\n    maxFilesPluralizationText?: string;\n    maxSizeBytes?: number;\n};\n\n/**\n * Context for drag events with drag-specific properties\n * Used to generate validation messages during file drag operations.\n *\n * @property draggedItems - The DataTransferItemList containing all items being dragged (not just rejected ones)\n * @property eventType - Always 'drag' for drag events\n */\nexport type DragMessageContext = BaseDynamicMessageContext & {\n    draggedItems?: DataTransferItemList;\n    eventType: 'drag';\n};\n\n/**\n * Context for drop events with drop-specific properties\n * Used to generate validation messages after files have been dropped.\n *\n * @property eventType - Always 'drop' for drop events\n * @property rejectedFileList - Comma-separated list of rejected file names\n * @property rejectedFiles - Array of File objects that failed validation\n */\nexport type DropMessageContext = BaseDynamicMessageContext & {\n    eventType: 'drop';\n    rejectedFileList?: string;\n    rejectedFiles?: File[];\n};\n\n/**\n * Guaranteed minimal properties available on all DynamicMessageContext variants.\n * This type represents the contract for what you can ALWAYS safely destructure\n * from any message context, regardless of whether it's a drag or drop event.\n *\n * Your custom validator message functions receive the full DynamicMessageContext,\n * but you can safely destructure just these core properties for simple validators.\n *\n * @property fileCount - Number of files involved in the validation\n * @property filePluralizationText - Properly pluralized text (e.g., \"file\" or \"files\")\n *\n * @example\n * // Simple validator - only uses guaranteed properties\n * const validator: FileValidator = (file) => {\n *   if (invalid) {\n *     return [{\n *       code: 'custom-error',\n *       message: ({ fileCount, filePluralizationText }) =>\n *         `${fileCount} ${filePluralizationText} failed validation`\n *     }];\n *   }\n *   return null;\n * };\n */\nexport type ValidationMessageContext = {\n    fileCount: number;\n    filePluralizationText: string;\n};\n\n/**\n * Context object provided to dynamic message functions in validators.\n * This is a union of drag and drop contexts, representing what's actually passed at runtime.\n *\n * While the full context includes many optional properties (like formattedMaxSize, maxFiles, etc.),\n * you can always safely destructure the core properties: fileCount and filePluralizationText\n * (see ValidationMessageContext for the guaranteed minimal subset).\n *\n * Use isDragContext or isDropContext type guards to access event-specific properties safely.\n */\nexport type DynamicMessageContext = DragMessageContext | DropMessageContext;\n\n/**\n * Type guard to check if a context is a drag context\n * Use this before accessing drag-specific properties\n *\n * @param context - The message context to check\n * @returns true if context is a drag context, false otherwise\n */\nexport const isDragContext = (context: DynamicMessageContext): context is DragMessageContext => {\n    return context.eventType === 'drag';\n};\n\n/**\n * Type guard to check if a context is a drop context\n * Use this before accessing drop-specific properties\n *\n * @param context - The message context to check\n * @returns true if context is a drop context, false otherwise\n */\nexport const isDropContext = (context: DynamicMessageContext): context is DropMessageContext => {\n    return context.eventType === 'drop';\n};\n\n/**\n * Parameters for generating validation messages\n * Used to create appropriate error messages for different validation scenarios.\n *\n * @property code - The error code that triggered the validation failure\n * @property count - Optional number of files that failed this specific validation\n * @property message - Optional message string or function that generates a message based on context\n * @property messageType - Optional string indicating the type of message ('drag' or 'drop')\n */\nexport type ValidationMessageParams = {\n    code: FileErrorCode;\n    count?: number;\n    message?: ContextAwareMessage<DynamicMessageContext>;\n    messageType?: 'drag' | 'drop';\n};\n\n/**\n * Represents a file validation error that can include dynamic messaging\n * Used during the validation process before messages are finalized.\n * This type allows for context-aware messages that can be resolved\n * at runtime based on the validation context.\n *\n * @property code - Error code identifying the type of validation failure\n * @property message - Human-readable error message or function that generates one\n * @remarks Used during validation process before messages are finalized\n */\nexport type DynamicFileError = {\n    code: FileErrorCode;\n    message: ContextAwareMessage<DynamicMessageContext>;\n};\n\n/**\n * Structure for processed validation error responses\n * The final form of validation errors after message resolution.\n * Unlike DynamicFileError, FileError messages are always strings,\n * as they have already been processed with context.\n *\n * @property code - Error code identifying the type of validation failure\n * @property message - Human-readable error message\n * @remarks Used for displaying validation results after message processing\n */\nexport type FileError = {\n    code: FileErrorCode;\n    message: string;\n};\n\n/**\n * Union type for validation errors that can be either a FileError or a DynamicFileError\n * This type allows for flexibility in handling different types of validation errors\n * and provides a common interface for processing them\n */\nexport type ValidationError = FileError | DynamicFileError;\n\n/**\n * Represents a file rejection from the upload process\n * Re-exported from react-dropzone for convenience\n *\n * @property file - The rejected file\n * @property errors - Array of errors associated with the rejected file\n */\nexport type FileRejection = ReactDropzoneFileRejection;\n\n/**\n * Predefined categories of file types\n * Used as a convenient shorthand for common file type groups\n *\n * @value 'images' - Common image formats (jpeg, png, gif, webp)\n * @value 'pdfs' - PDF documents only\n * @value 'documents' - Office and PDF documents (pdf, doc, docx, xls, xlsx)\n */\nexport type CommonFileTypes = 'images' | 'pdfs' | 'documents';\n\n/**\n * Ensures numbers are greater than 0; used for validation parameters\n * A type utility that prevents negative numbers or zero from being used\n * in places where only positive numbers make sense (e.g., file size limits)\n */\nexport type PositiveNumber = number extends infer N\n    ? N extends number\n        ? N extends 0\n            ? never\n            : N extends -1\n              ? never\n              : number\n        : never\n    : never;\n\n/**\n * Custom validation function for file uploads\n * Implement this to create custom validation rules beyond the built-in ones\n *\n * @param file - File or DataTransferItem to validate\n * @returns An array of ValidationError objects if validation fails, null if passes\n */\nexport type FileValidator = (file: File | DataTransferItem) => ValidationError[] | null;\n\n/**\n * Configuration for file validation\n * Used to set up validation rules and behavior for file uploads\n *\n * @property accept - Allowed file types (preset categories or MIME types/extensions)\n * @property error - Optional custom error to display regardless of validation results\n * @property maxFiles - Maximum number of files allowed\n * @property maxSize - Maximum file size in bytes\n * @property strictValidation - If true, rejects all files when any validation fails\n * @property validator - Optional custom validation function\n */\nexport type ValidationConfig = {\n    accept?: CommonFileTypes | string[];\n    error?: FileError;\n    maxFiles?: number;\n    maxSize?: number;\n    strictValidation?: boolean;\n    validator?: FileValidator;\n};\n"],"mappings":";;;;;;;;AAyIA,MAAa,iBAAiB,YAAkE;CAC5F,OAAO,QAAQ,cAAc;AACjC;;;;;;;;AASA,MAAa,iBAAiB,YAAkE;CAC5F,OAAO,QAAQ,cAAc;AACjC"}

package/fileUpload.cjs

@@ -0,0 +1,24 @@
+'use client';
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_hooks = require("./hooks-8VsDqwlb.cjs");
+const require_FileUpload = require("./FileUpload--e_UJ_ek.cjs");
+exports.FileCard = require_FileUpload.FileCard;
+exports.FileDropzone = require_FileUpload.FileDropzone;
+exports.FileDropzoneOverlay = require_FileUpload.FileDropzoneOverlay;
+exports.FilePreviewList = require_FileUpload.FilePreviewList;
+exports.FileUpload = require_FileUpload.FileUpload;
+exports.FileUploadCanvas = require_FileUpload.FileUploadCanvas;
+exports.FileUploadContext = require_FileUpload.FileUploadContext;
+exports.FileUploadProvider = require_FileUpload.FileUploadProvider;
+exports.GridFileCard = require_FileUpload.GridFileCard;
+exports.ListFileCard = require_FileUpload.ListFileCard;
+exports.UploadValidationContext = require_hooks.UploadValidationContext;
+exports.UploadValidationProvider = require_hooks.UploadValidationProvider;
+exports.getFileExtensionsFromAcceptedTypes = require_hooks.getFileExtensionsFromAcceptedTypes;
+exports.getFilePluralizationText = require_hooks.getFilePluralizationText;
+exports.useFileUploadContext = require_FileUpload.useFileUploadContext;
+exports.useFileValidation = require_hooks.useFileValidation;
+exports.useValidationContext = require_hooks.useValidationContext;

package/fileUpload.d.cts

@@ -0,0 +1,4 @@
+import { a as UploadValidationContext, b as ValidationError, c as useValidationContext, i as useFileUploadContext, r as FileUploadProvider, s as UploadValidationProvider, t as FileUploadContext } from "./index-BAR19_eg.cjs";
+import { n as useFileValidation } from "./index-Co9X1Vty.cjs";
+import { a as FileCard, c as FileDropzoneOverlay, d as FilePreviewList, f as FileCardAction, g as FileStatusIconConfig, h as FileStatusIcon, i as ListFileCard, l as FileUpload, m as FileStatusConfig, n as getFileExtensionsFromAcceptedTypes, o as FileDropzone, p as FileProgressCircleConfig, r as GridFileCard, s as FileUploadCanvas, t as getFilePluralizationText, u as OverlayStyleOptions } from "./index-CTfIOH2Z2.cjs";
+export { FileCard, type FileCardAction, FileDropzone, FileDropzoneOverlay, FilePreviewList, type FileProgressCircleConfig, type FileStatusConfig, type FileStatusIcon, type FileStatusIconConfig, FileUpload, FileUploadCanvas, FileUploadContext, FileUploadProvider, GridFileCard, ListFileCard, type OverlayStyleOptions, UploadValidationContext, UploadValidationProvider, type ValidationError, getFileExtensionsFromAcceptedTypes, getFilePluralizationText, useFileUploadContext, useFileValidation, useValidationContext };

package/fileUpload.d.mts

@@ -0,0 +1,4 @@
+import { a as UploadValidationContext, b as ValidationError, c as useValidationContext, i as useFileUploadContext, r as FileUploadProvider, s as UploadValidationProvider, t as FileUploadContext } from "./index-BAR19_eg.mjs";
+import { n as useFileValidation } from "./index-CQb7B4U7.mjs";
+import { a as FileCard, c as FileDropzoneOverlay, d as FilePreviewList, f as FileCardAction, g as FileStatusIconConfig, h as FileStatusIcon, i as ListFileCard, l as FileUpload, m as FileStatusConfig, n as getFileExtensionsFromAcceptedTypes, o as FileDropzone, p as FileProgressCircleConfig, r as GridFileCard, s as FileUploadCanvas, t as getFilePluralizationText, u as OverlayStyleOptions } from "./index-B-GVogfk2.mjs";
+export { FileCard, type FileCardAction, FileDropzone, FileDropzoneOverlay, FilePreviewList, type FileProgressCircleConfig, type FileStatusConfig, type FileStatusIcon, type FileStatusIconConfig, FileUpload, FileUploadCanvas, FileUploadContext, FileUploadProvider, GridFileCard, ListFileCard, type OverlayStyleOptions, UploadValidationContext, UploadValidationProvider, type ValidationError, getFileExtensionsFromAcceptedTypes, getFilePluralizationText, useFileUploadContext, useFileValidation, useValidationContext };

package/fileUpload.mjs

@@ -0,0 +1,4 @@
+'use client';
+import { a as useValidationContext, c as getFilePluralizationText, i as UploadValidationProvider, l as getFileExtensionsFromAcceptedTypes, n as useFileValidation, r as UploadValidationContext } from "./hooks-D4sJ62Xl.mjs";
+import { a as FileCard, c as FileDropzone, d as useFileUploadContext, i as FilePreviewList, l as FileUploadContext, n as FileDropzoneOverlay, o as ListFileCard, r as FileUpload, s as GridFileCard, t as FileUploadCanvas, u as FileUploadProvider } from "./FileUpload-p_pl9NXr.mjs";
+export { FileCard, FileDropzone, FileDropzoneOverlay, FilePreviewList, FileUpload, FileUploadCanvas, FileUploadContext, FileUploadProvider, GridFileCard, ListFileCard, UploadValidationContext, UploadValidationProvider, getFileExtensionsFromAcceptedTypes, getFilePluralizationText, useFileUploadContext, useFileValidation, useValidationContext };

package/formLabel.cjs

@@ -0,0 +1,108 @@
+'use client';
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_Icons = require("./Icons.cjs");
+const require_Typography_Text = require("./Typography/Text.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/FormLabel/FormLabel.tsx
+/**
+* Here's a quick snippet of code to forward all props
+* ```tsx
+* <FormLabel
+* className={className}
+* disabled={disabled}
+* errorText={errorText}
+* errorTextId={errorTextId}
+* hasError={hasError}
+* helpText={helpText}
+* labelText={labelText}
+* secure={secure}
+* showTopLeft={showTopLeft}
+* showTopRight={showTopRight}
+* topLeft={topLeft}
+* topRight={topRight}
+* ```
+*/
+const FormLabel = (0, react.forwardRef)(({ children, className, disabled, errorText, errorTextId, hasError = false, helpText, labelText, renderErrorTextAdjacent, renderHelpTextAdjacent, secure = false, showTopLeft = Boolean(labelText), showTopRight = secure, topLeft = /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+	className: (0, _evolve_ui_theme_system.cn)("hui-text-label-mini whitespace-nowrap", {
+		"text-text-disabled": disabled,
+		"text-text-secondary": !disabled
+	}),
+	children: labelText
+}), topRight = /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+	className: (0, _evolve_ui_theme_system.cn)("hui-text-label-mini ml-auto flex items-center gap-[2px] text-text-secondary", {
+		"text-text-disabled": disabled,
+		"text-text-secondary": !disabled
+	}),
+	children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Icons.Lock, {
+		size: "xs",
+		style: "fill"
+	}), "Secure"]
+}), ...rest }, ref) => {
+	const help = Boolean(helpText) ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+		className: (0, _evolve_ui_theme_system.cn)("hui-text-caption whitespace-nowrap", {
+			"text-text-disabled": disabled,
+			"text-text-secondary": !disabled
+		}),
+		children: helpText
+	}) : null;
+	const error = Boolean(errorText) && hasError ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Typography_Text.Caption, {
+		color: "critical",
+		id: errorTextId,
+		children: errorText
+	}) : null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+		/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+			...rest,
+			className: (0, _evolve_ui_theme_system.cn)("flex flex-col gap-2xs", className),
+			ref,
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(FormLabelHeader, {
+					showTopLeft,
+					showTopRight,
+					topLeft,
+					topRight
+				}),
+				children,
+				!renderHelpTextAdjacent && help,
+				!renderErrorTextAdjacent && error
+			]
+		}),
+		renderHelpTextAdjacent && help,
+		renderErrorTextAdjacent && error
+	] });
+});
+const FormLabelHeader = ({ showTopLeft, showTopRight, topLeft, topRight }) => {
+	if (!showTopLeft && !showTopRight) return null;
+	if (showTopLeft && !showTopRight) return topLeft;
+	if (!showTopLeft && showTopRight) return topRight;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "flex items-center",
+		children: [showTopLeft && topLeft, showTopRight && topRight]
+	});
+};
+const extractFormLabelProps = (props) => {
+	const { className, disabled, errorText, errorTextId, hasError, helpText, labelText, secure, ...rest } = props;
+	return [{
+		className,
+		disabled,
+		errorText,
+		errorTextId,
+		hasError,
+		helpText,
+		labelText,
+		secure
+	}, {
+		disabled,
+		...rest
+	}];
+};
+//#endregion
+exports.FormLabel = FormLabel;
+exports.extractFormLabelProps = extractFormLabelProps;
+
+//# sourceMappingURL=formLabel.cjs.map

package/formLabel.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formLabel.cjs","names":["Lock","Caption"],"sources":["../src/FormLabel/FormLabel.tsx"],"sourcesContent":["import { cn } from '@evolve.ui/theme-system';\nimport { forwardRef, HTMLProps, ReactNode } from 'react';\n\nimport { Lock } from '../Icons';\nimport { Caption } from '../Typography/Text/Text';\n\n// This is imported in other files, hence, not just \"Props\"\ntype Props = {\n    className?: string;\n    disabled?: boolean;\n    /**\n     * Whether to show the error text / styles.\n     */\n    hasError?: boolean;\n    helpText?: ReactNode;\n    labelText?: ReactNode;\n    /** Render the text as a sibling of the label rather than a child of label */\n    renderErrorTextAdjacent?: boolean;\n    /** Render the text as a sibling of the label rather than a child of label */\n    renderHelpTextAdjacent?: boolean;\n    /**\n     * Show secure label at the top right of the component.\n     */\n    secure?: boolean;\n    /* Useful for overriding */\n    showTopLeft?: boolean;\n    /* Useful for overriding */\n    showTopRight?: boolean;\n    /* Useful for overriding */\n    topLeft?: ReactNode;\n    /* Useful for overriding */\n    topRight?: ReactNode;\n} & (\n    | {\n          errorText?: ReactNode;\n          /**\n           * Must be defined if `errorText` is defined.\n           */\n          errorTextId?: undefined;\n      }\n    | {\n          errorText?: undefined;\n          /**\n           * Must be defined if `errorText` is defined.\n           */\n          errorTextId: string;\n      }\n    | {\n          errorText: ReactNode;\n          /**\n           * Must be defined if `errorText` is defined.\n           */\n          errorTextId: string;\n      }\n);\n\nexport type FormLabelProps = Omit<\n    Props,\n    'topLeft' | 'topRight' | 'showTopLeft' | 'showTopRight' | 'renderErrorTextAdjacent' | 'renderHelpTextAdjacent'\n>;\n\n/**\n * Here's a quick snippet of code to forward all props\n * ```tsx\n * <FormLabel\n * className={className}\n * disabled={disabled}\n * errorText={errorText}\n * errorTextId={errorTextId}\n * hasError={hasError}\n * helpText={helpText}\n * labelText={labelText}\n * secure={secure}\n * showTopLeft={showTopLeft}\n * showTopRight={showTopRight}\n * topLeft={topLeft}\n * topRight={topRight}\n * ```\n */\nexport const FormLabel = forwardRef<HTMLLabelElement, Props & HTMLProps<HTMLLabelElement>>(\n    (\n        {\n            children,\n            className,\n            disabled,\n            errorText,\n            errorTextId,\n            hasError = false,\n            helpText,\n            labelText,\n            renderErrorTextAdjacent,\n            renderHelpTextAdjacent,\n            secure = false,\n            showTopLeft = Boolean(labelText),\n            showTopRight = secure,\n            topLeft = (\n                <span\n                    className={cn('hui-text-label-mini whitespace-nowrap', {\n                        'text-text-disabled': disabled,\n                        'text-text-secondary': !disabled,\n                    })}\n                >\n                    {labelText}\n                </span>\n            ),\n            topRight = (\n                <span\n                    className={cn('hui-text-label-mini ml-auto flex items-center gap-[2px] text-text-secondary', {\n                        'text-text-disabled': disabled,\n                        'text-text-secondary': !disabled,\n                    })}\n                >\n                    <Lock\n                        size=\"xs\"\n                        style=\"fill\"\n                    />\n                    Secure\n                </span>\n            ),\n            ...rest\n        },\n        ref\n    ) => {\n        const help = Boolean(helpText) ? (\n            <span\n                className={cn('hui-text-caption whitespace-nowrap', {\n                    'text-text-disabled': disabled,\n                    'text-text-secondary': !disabled,\n                })}\n            >\n                {helpText}\n            </span>\n        ) : null;\n        const error =\n            Boolean(errorText) && hasError ? (\n                <Caption\n                    color=\"critical\"\n                    id={errorTextId}\n                >\n                    {errorText}\n                </Caption>\n            ) : null;\n\n        return (\n            <>\n                <label\n                    {...rest}\n                    className={cn('flex flex-col gap-2xs', className)}\n                    ref={ref}\n                >\n                    <FormLabelHeader\n                        showTopLeft={showTopLeft}\n                        showTopRight={showTopRight}\n                        topLeft={topLeft}\n                        topRight={topRight}\n                    />\n                    {children}\n                    {!renderHelpTextAdjacent && help}\n                    {!renderErrorTextAdjacent && error}\n                </label>\n                {renderHelpTextAdjacent && help}\n                {renderErrorTextAdjacent && error}\n            </>\n        );\n    }\n);\n\nconst FormLabelHeader = ({\n    showTopLeft,\n    showTopRight,\n    topLeft,\n    topRight,\n}: Pick<Props, 'topLeft' | 'topRight' | 'showTopLeft' | 'showTopRight'>) => {\n    if (!showTopLeft && !showTopRight) {\n        return null;\n    }\n\n    if (showTopLeft && !showTopRight) {\n        return topLeft;\n    }\n\n    if (!showTopLeft && showTopRight) {\n        return topRight;\n    }\n\n    return (\n        <div className=\"flex items-center\">\n            {showTopLeft && topLeft}\n            {showTopRight && topRight}\n        </div>\n    );\n};\n\nexport const extractFormLabelProps = <T extends FormLabelProps>(\n    props: T\n): [FormLabelProps, Omit<T, keyof FormLabelProps> & Pick<FormLabelProps, 'disabled'>] => {\n    const { className, disabled, errorText, errorTextId, hasError, helpText, labelText, secure, ...rest } = props;\n\n    return [\n        {\n            className,\n            disabled,\n            errorText,\n            errorTextId,\n            hasError,\n            helpText,\n            labelText,\n            secure,\n        },\n        { disabled, ...rest },\n    ];\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+EA,MAAa,aAAA,GAAA,MAAA,WAAA,EAEL,EACI,UACA,WACA,UACA,WACA,aACA,WAAW,OACX,UACA,WACA,yBACA,wBACA,SAAS,OACT,cAAc,QAAQ,SAAS,GAC/B,eAAe,QACf,UACI,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;CACI,YAAA,GAAA,wBAAA,GAAA,CAAc,yCAAyC;EACnD,sBAAsB;EACtB,uBAAuB,CAAC;CAC5B,CAAC;WAEA;AACC,CAAA,GAEV,WACI,iBAAA,GAAA,kBAAA,KAAA,CAAC,QAAD;CACI,YAAA,GAAA,wBAAA,GAAA,CAAc,+EAA+E;EACzF,sBAAsB;EACtB,uBAAuB,CAAC;CAC5B,CAAC;WAJL,CAMI,iBAAA,GAAA,kBAAA,IAAA,CAACA,cAAAA,MAAD;EACI,MAAK;EACL,OAAM;CACT,CAAA,GAAC,QAEA;IAEV,GAAG,QAEP,QACC;CACD,MAAM,OAAO,QAAQ,QAAQ,IACzB,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;EACI,YAAA,GAAA,wBAAA,GAAA,CAAc,sCAAsC;GAChD,sBAAsB;GACtB,uBAAuB,CAAC;EAC5B,CAAC;YAEA;CACC,CAAA,IACN;CACJ,MAAM,QACF,QAAQ,SAAS,KAAK,WAClB,iBAAA,GAAA,kBAAA,IAAA,CAACC,wBAAAA,SAAD;EACI,OAAM;EACN,IAAI;YAEH;CACI,CAAA,IACT;CAER,OACI,iBAAA,GAAA,kBAAA,KAAA,CAAA,kBAAA,UAAA,EAAA,UAAA;EACI,iBAAA,GAAA,kBAAA,KAAA,CAAC,SAAD;GACI,GAAI;GACJ,YAAA,GAAA,wBAAA,GAAA,CAAc,yBAAyB,SAAS;GAC3C;aAHT;IAKI,iBAAA,GAAA,kBAAA,IAAA,CAAC,iBAAD;KACiB;KACC;KACL;KACC;IACb,CAAA;IACA;IACA,CAAC,0BAA0B;IAC3B,CAAC,2BAA2B;GAC1B;;EACN,0BAA0B;EAC1B,2BAA2B;CAC9B,EAAA,CAAA;AAEV,CACJ;AAEA,MAAM,mBAAmB,EACrB,aACA,cACA,SACA,eACwE;CACxE,IAAI,CAAC,eAAe,CAAC,cACjB,OAAO;CAGX,IAAI,eAAe,CAAC,cAChB,OAAO;CAGX,IAAI,CAAC,eAAe,cAChB,OAAO;CAGX,OACI,iBAAA,GAAA,kBAAA,KAAA,CAAC,OAAD;EAAK,WAAU;YAAf,CACK,eAAe,SACf,gBAAgB,QAChB;;AAEb;AAEA,MAAa,yBACT,UACqF;CACrF,MAAM,EAAE,WAAW,UAAU,WAAW,aAAa,UAAU,UAAU,WAAW,QAAQ,GAAG,SAAS;CAExG,OAAO,CACH;EACI;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACJ,GACA;EAAE;EAAU,GAAG;CAAK,CACxB;AACJ"}

package/formLabel.d.cts

@@ -0,0 +1,2 @@
+import { n as FormLabelProps, r as extractFormLabelProps, t as FormLabel } from "./FormLabel-D4602qfd.cjs";
+export { FormLabel, FormLabelProps, extractFormLabelProps };

package/formLabel.d.mts

@@ -0,0 +1,2 @@
+import { n as FormLabelProps, r as extractFormLabelProps, t as FormLabel } from "./FormLabel-D4602qfd.mjs";
+export { FormLabel, FormLabelProps, extractFormLabelProps };

package/formLabel.mjs

@@ -0,0 +1,103 @@
+'use client';
+import { Lock } from "./Icons.mjs";
+import { Caption } from "./Typography/Text.mjs";
+import { cn } from "@evolve.ui/theme-system";
+import { forwardRef } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+//#region src/FormLabel/FormLabel.tsx
+/**
+* Here's a quick snippet of code to forward all props
+* ```tsx
+* <FormLabel
+* className={className}
+* disabled={disabled}
+* errorText={errorText}
+* errorTextId={errorTextId}
+* hasError={hasError}
+* helpText={helpText}
+* labelText={labelText}
+* secure={secure}
+* showTopLeft={showTopLeft}
+* showTopRight={showTopRight}
+* topLeft={topLeft}
+* topRight={topRight}
+* ```
+*/
+const FormLabel = forwardRef(({ children, className, disabled, errorText, errorTextId, hasError = false, helpText, labelText, renderErrorTextAdjacent, renderHelpTextAdjacent, secure = false, showTopLeft = Boolean(labelText), showTopRight = secure, topLeft = /* @__PURE__ */ jsx("span", {
+	className: cn("hui-text-label-mini whitespace-nowrap", {
+		"text-text-disabled": disabled,
+		"text-text-secondary": !disabled
+	}),
+	children: labelText
+}), topRight = /* @__PURE__ */ jsxs("span", {
+	className: cn("hui-text-label-mini ml-auto flex items-center gap-[2px] text-text-secondary", {
+		"text-text-disabled": disabled,
+		"text-text-secondary": !disabled
+	}),
+	children: [/* @__PURE__ */ jsx(Lock, {
+		size: "xs",
+		style: "fill"
+	}), "Secure"]
+}), ...rest }, ref) => {
+	const help = Boolean(helpText) ? /* @__PURE__ */ jsx("span", {
+		className: cn("hui-text-caption whitespace-nowrap", {
+			"text-text-disabled": disabled,
+			"text-text-secondary": !disabled
+		}),
+		children: helpText
+	}) : null;
+	const error = Boolean(errorText) && hasError ? /* @__PURE__ */ jsx(Caption, {
+		color: "critical",
+		id: errorTextId,
+		children: errorText
+	}) : null;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		/* @__PURE__ */ jsxs("label", {
+			...rest,
+			className: cn("flex flex-col gap-2xs", className),
+			ref,
+			children: [
+				/* @__PURE__ */ jsx(FormLabelHeader, {
+					showTopLeft,
+					showTopRight,
+					topLeft,
+					topRight
+				}),
+				children,
+				!renderHelpTextAdjacent && help,
+				!renderErrorTextAdjacent && error
+			]
+		}),
+		renderHelpTextAdjacent && help,
+		renderErrorTextAdjacent && error
+	] });
+});
+const FormLabelHeader = ({ showTopLeft, showTopRight, topLeft, topRight }) => {
+	if (!showTopLeft && !showTopRight) return null;
+	if (showTopLeft && !showTopRight) return topLeft;
+	if (!showTopLeft && showTopRight) return topRight;
+	return /* @__PURE__ */ jsxs("div", {
+		className: "flex items-center",
+		children: [showTopLeft && topLeft, showTopRight && topRight]
+	});
+};
+const extractFormLabelProps = (props) => {
+	const { className, disabled, errorText, errorTextId, hasError, helpText, labelText, secure, ...rest } = props;
+	return [{
+		className,
+		disabled,
+		errorText,
+		errorTextId,
+		hasError,
+		helpText,
+		labelText,
+		secure
+	}, {
+		disabled,
+		...rest
+	}];
+};
+//#endregion
+export { FormLabel, extractFormLabelProps };
+
+//# sourceMappingURL=formLabel.mjs.map

package/formLabel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formLabel.mjs","names":[],"sources":["../src/FormLabel/FormLabel.tsx"],"sourcesContent":["import { cn } from '@evolve.ui/theme-system';\nimport { forwardRef, HTMLProps, ReactNode } from 'react';\n\nimport { Lock } from '../Icons';\nimport { Caption } from '../Typography/Text/Text';\n\n// This is imported in other files, hence, not just \"Props\"\ntype Props = {\n    className?: string;\n    disabled?: boolean;\n    /**\n     * Whether to show the error text / styles.\n     */\n    hasError?: boolean;\n    helpText?: ReactNode;\n    labelText?: ReactNode;\n    /** Render the text as a sibling of the label rather than a child of label */\n    renderErrorTextAdjacent?: boolean;\n    /** Render the text as a sibling of the label rather than a child of label */\n    renderHelpTextAdjacent?: boolean;\n    /**\n     * Show secure label at the top right of the component.\n     */\n    secure?: boolean;\n    /* Useful for overriding */\n    showTopLeft?: boolean;\n    /* Useful for overriding */\n    showTopRight?: boolean;\n    /* Useful for overriding */\n    topLeft?: ReactNode;\n    /* Useful for overriding */\n    topRight?: ReactNode;\n} & (\n    | {\n          errorText?: ReactNode;\n          /**\n           * Must be defined if `errorText` is defined.\n           */\n          errorTextId?: undefined;\n      }\n    | {\n          errorText?: undefined;\n          /**\n           * Must be defined if `errorText` is defined.\n           */\n          errorTextId: string;\n      }\n    | {\n          errorText: ReactNode;\n          /**\n           * Must be defined if `errorText` is defined.\n           */\n          errorTextId: string;\n      }\n);\n\nexport type FormLabelProps = Omit<\n    Props,\n    'topLeft' | 'topRight' | 'showTopLeft' | 'showTopRight' | 'renderErrorTextAdjacent' | 'renderHelpTextAdjacent'\n>;\n\n/**\n * Here's a quick snippet of code to forward all props\n * ```tsx\n * <FormLabel\n * className={className}\n * disabled={disabled}\n * errorText={errorText}\n * errorTextId={errorTextId}\n * hasError={hasError}\n * helpText={helpText}\n * labelText={labelText}\n * secure={secure}\n * showTopLeft={showTopLeft}\n * showTopRight={showTopRight}\n * topLeft={topLeft}\n * topRight={topRight}\n * ```\n */\nexport const FormLabel = forwardRef<HTMLLabelElement, Props & HTMLProps<HTMLLabelElement>>(\n    (\n        {\n            children,\n            className,\n            disabled,\n            errorText,\n            errorTextId,\n            hasError = false,\n            helpText,\n            labelText,\n            renderErrorTextAdjacent,\n            renderHelpTextAdjacent,\n            secure = false,\n            showTopLeft = Boolean(labelText),\n            showTopRight = secure,\n            topLeft = (\n                <span\n                    className={cn('hui-text-label-mini whitespace-nowrap', {\n                        'text-text-disabled': disabled,\n                        'text-text-secondary': !disabled,\n                    })}\n                >\n                    {labelText}\n                </span>\n            ),\n            topRight = (\n                <span\n                    className={cn('hui-text-label-mini ml-auto flex items-center gap-[2px] text-text-secondary', {\n                        'text-text-disabled': disabled,\n                        'text-text-secondary': !disabled,\n                    })}\n                >\n                    <Lock\n                        size=\"xs\"\n                        style=\"fill\"\n                    />\n                    Secure\n                </span>\n            ),\n            ...rest\n        },\n        ref\n    ) => {\n        const help = Boolean(helpText) ? (\n            <span\n                className={cn('hui-text-caption whitespace-nowrap', {\n                    'text-text-disabled': disabled,\n                    'text-text-secondary': !disabled,\n                })}\n            >\n                {helpText}\n            </span>\n        ) : null;\n        const error =\n            Boolean(errorText) && hasError ? (\n                <Caption\n                    color=\"critical\"\n                    id={errorTextId}\n                >\n                    {errorText}\n                </Caption>\n            ) : null;\n\n        return (\n            <>\n                <label\n                    {...rest}\n                    className={cn('flex flex-col gap-2xs', className)}\n                    ref={ref}\n                >\n                    <FormLabelHeader\n                        showTopLeft={showTopLeft}\n                        showTopRight={showTopRight}\n                        topLeft={topLeft}\n                        topRight={topRight}\n                    />\n                    {children}\n                    {!renderHelpTextAdjacent && help}\n                    {!renderErrorTextAdjacent && error}\n                </label>\n                {renderHelpTextAdjacent && help}\n                {renderErrorTextAdjacent && error}\n            </>\n        );\n    }\n);\n\nconst FormLabelHeader = ({\n    showTopLeft,\n    showTopRight,\n    topLeft,\n    topRight,\n}: Pick<Props, 'topLeft' | 'topRight' | 'showTopLeft' | 'showTopRight'>) => {\n    if (!showTopLeft && !showTopRight) {\n        return null;\n    }\n\n    if (showTopLeft && !showTopRight) {\n        return topLeft;\n    }\n\n    if (!showTopLeft && showTopRight) {\n        return topRight;\n    }\n\n    return (\n        <div className=\"flex items-center\">\n            {showTopLeft && topLeft}\n            {showTopRight && topRight}\n        </div>\n    );\n};\n\nexport const extractFormLabelProps = <T extends FormLabelProps>(\n    props: T\n): [FormLabelProps, Omit<T, keyof FormLabelProps> & Pick<FormLabelProps, 'disabled'>] => {\n    const { className, disabled, errorText, errorTextId, hasError, helpText, labelText, secure, ...rest } = props;\n\n    return [\n        {\n            className,\n            disabled,\n            errorText,\n            errorTextId,\n            hasError,\n            helpText,\n            labelText,\n            secure,\n        },\n        { disabled, ...rest },\n    ];\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA+EA,MAAa,YAAY,YAEjB,EACI,UACA,WACA,UACA,WACA,aACA,WAAW,OACX,UACA,WACA,yBACA,wBACA,SAAS,OACT,cAAc,QAAQ,SAAS,GAC/B,eAAe,QACf,UACI,oBAAC,QAAD;CACI,WAAW,GAAG,yCAAyC;EACnD,sBAAsB;EACtB,uBAAuB,CAAC;CAC5B,CAAC;WAEA;AACC,CAAA,GAEV,WACI,qBAAC,QAAD;CACI,WAAW,GAAG,+EAA+E;EACzF,sBAAsB;EACtB,uBAAuB,CAAC;CAC5B,CAAC;WAJL,CAMI,oBAAC,MAAD;EACI,MAAK;EACL,OAAM;CACT,CAAA,GAAC,QAEA;IAEV,GAAG,QAEP,QACC;CACD,MAAM,OAAO,QAAQ,QAAQ,IACzB,oBAAC,QAAD;EACI,WAAW,GAAG,sCAAsC;GAChD,sBAAsB;GACtB,uBAAuB,CAAC;EAC5B,CAAC;YAEA;CACC,CAAA,IACN;CACJ,MAAM,QACF,QAAQ,SAAS,KAAK,WAClB,oBAAC,SAAD;EACI,OAAM;EACN,IAAI;YAEH;CACI,CAAA,IACT;CAER,OACI,qBAAA,UAAA,EAAA,UAAA;EACI,qBAAC,SAAD;GACI,GAAI;GACJ,WAAW,GAAG,yBAAyB,SAAS;GAC3C;aAHT;IAKI,oBAAC,iBAAD;KACiB;KACC;KACL;KACC;IACb,CAAA;IACA;IACA,CAAC,0BAA0B;IAC3B,CAAC,2BAA2B;GAC1B;;EACN,0BAA0B;EAC1B,2BAA2B;CAC9B,EAAA,CAAA;AAEV,CACJ;AAEA,MAAM,mBAAmB,EACrB,aACA,cACA,SACA,eACwE;CACxE,IAAI,CAAC,eAAe,CAAC,cACjB,OAAO;CAGX,IAAI,eAAe,CAAC,cAChB,OAAO;CAGX,IAAI,CAAC,eAAe,cAChB,OAAO;CAGX,OACI,qBAAC,OAAD;EAAK,WAAU;YAAf,CACK,eAAe,SACf,gBAAgB,QAChB;;AAEb;AAEA,MAAa,yBACT,UACqF;CACrF,MAAM,EAAE,WAAW,UAAU,WAAW,aAAa,UAAU,UAAU,WAAW,QAAQ,GAAG,SAAS;CAExG,OAAO,CACH;EACI;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACJ,GACA;EAAE;EAAU,GAAG;CAAK,CACxB;AACJ"}