@evolve.ui/core-components 1.0.0

package/index-9649Aqry.d.mts

@@ -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.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index-9649Aqry.d.mts","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"}

package/index-B-GVogfk2.d.mts

@@ -0,0 +1,519 @@
+import { r as IconProps } from "./IconBase-C_Lx9rDx.mjs";
+import { t as AnyIcon } from "./anyIcon-eR07wvJb.mjs";
+import { f as FileError, g as FileValidator, h as FileResource, l as CommonFileTypes, m as FileRejection } from "./index-BAR19_eg.mjs";
+import { t as LoadingSpinner } from "./LoadingSpinner-BWwhuAGb.mjs";
+import { t as ProgressCircle } from "./ProgressCircle-CxrflaLd.mjs";
+import { CSSProperties, ComponentProps } from "react";
+import { DraggableAttributes } from "@dnd-kit/core";
+import { SyntheticListenerMap } from "@dnd-kit/core/dist/hooks/utilities";
+
+//#region src/FileUpload/components/types.d.ts
+type FileCardAction = {
+  icon: AnyIcon;
+  iconStyle?: IconProps['style'];
+  name: string;
+  onClick: (e: React.MouseEvent<HTMLElement>, fileResource: FileResource) => void;
+};
+type FileStatusIconConfig = {
+  color?: IconProps['color'];
+  icon: AnyIcon | typeof LoadingSpinner;
+  style?: IconProps['style'];
+  type: 'icon';
+};
+type FileProgressCircleConfig = {
+  centerIcon?: ComponentProps<typeof ProgressCircle>['centerIcon'];
+  color?: ComponentProps<typeof ProgressCircle>['color'];
+  indeterminateAnimation?: ComponentProps<typeof ProgressCircle>['indeterminateAnimation'];
+  type: 'progressCircle';
+};
+type FileStatusIcon = FileStatusIconConfig | FileProgressCircleConfig;
+type FileStatusConfig = {
+  errorMessage?: string;
+  progress?: number;
+  status?: 'default' | 'pending' | 'progressing' | 'complete' | 'error';
+  statusIcon?: FileStatusIcon;
+  statusText?: string;
+};
+type PreviewStyle = 'list' | 'compactList' | 'grid';
+type BaseFileCardStyle = 'contained' | 'compact' | 'card';
+type ListFileCardStyle = 'contained' | 'compact';
+type BaseFileCardProps = {
+  /**
+   * GridCard Only: First 3 actions will be visible buttons,
+   * remaining will appear in overflow menu.
+   */
+  actions?: FileCardAction[];
+  className?: string;
+  draggable?: boolean;
+  errorMessage?: string;
+  fileName?: string;
+  hideFileName?: boolean;
+  hideFileSize?: boolean;
+  hideFileStatus?: boolean;
+  imageSource: FileResource;
+  isSelected?: boolean;
+  onDelete?: (fileResource: FileResource) => void;
+  onImageError?: (fileResource: FileResource) => void;
+  onSelect?: (fileResource: FileResource, isSelected: boolean) => void; /** Progress percentage (0-100) for the file upload/processing */
+  progress?: number;
+  selectable?: boolean;
+  sortable?: {
+    attributes?: DraggableAttributes;
+    isDragging?: boolean;
+    listeners?: SyntheticListenerMap;
+    setNodeRef: (node: HTMLElement | null) => void;
+    styles?: CSSProperties;
+  };
+  status?: 'default' | 'pending' | 'progressing' | 'complete' | 'error';
+  statusIcon?: FileStatusIcon;
+} & ({
+  isSelected: boolean;
+  selectable: true;
+} | {
+  isSelected?: boolean;
+  selectable?: false;
+});
+//#endregion
+//#region src/FileUpload/components/FilePreviewList/FilePreviewList.d.ts
+type ColsByBreakpoint = {
+  xs: number;
+} & { [key in 'sm' | 'md' | 'lg' | 'xl']?: number };
+type FilePreviewListProps = {
+  /** Whether files in the list can be selected (or checked) */bulkSelectionEnabled?: boolean; /** Additional CSS classes */
+  className?: string; /** Number of columns to display at each breakpoint, allowing you to create a custom grid layout. (grid view only) */
+  colsByBreakpoint?: ColsByBreakpoint; /** Test ID for the component */
+  'data-testid'?: string; /** Whether files can be dragged and sorted */
+  draggable?: boolean; /** Array of Files or RemoteFile Objects (typically with URLs) to display in the preview list */
+  files?: FileResource[]; /** Callback to configure status display (status, progress, error, icon, text) for each file */
+  getFileStatusConfig?: (file: FileResource, index: number) => FileStatusConfig | undefined; /** Whether to hide the delete action on the file cards */
+  hideDeleteAction?: boolean; /** Whether to hide the file names on the file cards */
+  hideFileNames?: boolean; /** Whether to hide the file sizes on the file cards */
+  hideFileSizes?: boolean; /** Whether to hide status messages on the file cards (error messages, "Pending", "Uploading", and custom statusText) */
+  hideFileStatuses?: boolean; /** Called when user clicks delete button on a file preview */
+  onDelete?: (fileResource: FileResource) => void; /** Called when user selects or deselects a file */
+  onSelect?: (fileResource: FileResource, isSelected: boolean) => void; /** Determines the view style for the file preview list */
+  previewStyle?: PreviewStyle; /** Whether to show delete button or other actions on hover (list view only) */
+  showActionsOnHover?: boolean; /** Whether to use a virtualized list (Only used if previewStyle is list or compactList) */
+  virtualized?: boolean;
+};
+declare const FilePreviewList: {
+  ({
+    bulkSelectionEnabled,
+    className,
+    colsByBreakpoint,
+    "data-testid": dataTestId,
+    draggable,
+    files: filesProp,
+    getFileStatusConfig,
+    hideDeleteAction,
+    hideFileNames,
+    hideFileSizes,
+    hideFileStatuses,
+    onDelete,
+    onSelect,
+    previewStyle,
+    showActionsOnHover,
+    virtualized
+  }: FilePreviewListProps): import("react/jsx-runtime").JSX.Element;
+  displayName: string;
+};
+//#endregion
+//#region src/FileUpload/types/sharedTypes.d.ts
+/**
+ * Core functionality props shared across file upload components.
+ * These handle the main file upload behaviors and callbacks.
+ */
+type CoreUploadProps = {
+  /** Whether to disable early drag validation feedback*/disableDragValidation?: boolean; /** Whether the upload is disabled */
+  disabled?: boolean; /** Error object to display custom validation errors */
+  error?: FileError; /** Whether to hide error messages in the UI */
+  hideErrors?: boolean; /** Maximum number of files (1 for single file, undefined for unlimited) */
+  maxFiles?: number; /** Maximum allowed file size in bytes (Unrestricted by default) */
+  maxSize?: number; /** Callback when files are dropped */
+  onDrop?: (acceptedFiles: File[], rejectedFiles: FileRejection[]) => void; /** Callback when files are accepted */
+  onDropAccepted?: (files: File[]) => void;
+  /** Called when files fail validation with detailed rejection reasons
+   * Use case: Show specific error messages for each rejected file
+   * Example: "file.pdf is too large" or "file.exe is not an allowed type"
+   */
+  onDropRejected?: (rejectedFiles: FileRejection[]) => void;
+  /** Called when user clicks delete button on a file preview
+   * Use case: Remove file from server/state, update UI
+   */
+  onFileDelete?: (fileResource: FileResource) => void; /** Simple callback for file changes - alternative to granular callbacks */
+  onFilesChange?: (files: FileResource[]) => void; /** Whether to show the debugger display - to review file rejections and more*/
+  showDebugger?: boolean; /** Reject all files if any fail validation (strict mode) */
+  strictValidation?: boolean;
+};
+/**
+ * UI-specific props shared across file upload components.
+ * These control visual aspects and accessibility features.
+ */
+type UIProps = {
+  /** Custom styling for the file upload component */className?: string; /** Custom data-testid for the file upload component */
+  'data-testid'?: string; /** Custom caption text displayed below the upload input */
+  helpText?: string; /** Aligns the help text to the center, overriding the default left alignment */
+  helpTextAlignCenter?: boolean; /** Whether to hide the help text */
+  hideHelpText?: boolean; /** Custom label to show above the upload input */
+  labelText?: string;
+};
+/**
+ * Additional shared props that don't fit into core or UI categories.
+ * These handle file type restrictions and custom validation.
+ */
+type SharedUploadProps = {
+  /** Allowed file types - either preset categories or custom MIME types */accept?: CommonFileTypes | string[]; /** Custom aria-label for the upload zone */
+  ariaLabel?: string; /** Custom validator function for file validation - there are default validations for maxFiles and maxSize and accept (mime types) */
+  validator?: FileValidator;
+};
+/**
+ * Complete props for the FileDropzone component.
+ * Similar to FileUploadProps but with different component-specific options.
+ */
+type FileDropzoneProps = CoreUploadProps & UIProps & SharedUploadProps & {
+  /** Array of accepted files - typically comes from external state or context
+   * (often used to display files in the preview list) */
+  files?: FileResource[];
+};
+type OverlayStyleOptions = {
+  /** Apply backdrop blur effect during drag. Default: false (opt-in for performance) */blurOnDrag?: boolean;
+  /**
+   * Whether the overlay should fill the parent container's height.
+   * When true: Applies h-full to expand to parent height
+   * When false/undefined (default): Applies relative positioning for natural content flow
+   */
+  fillParent?: boolean;
+  /**
+   * Padding around the wrapped children (Tailwind spacing value).
+   * Default: undefined (no additional padding)
+   */
+  innerPadding?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
+  /**
+   * Show outline borders (dashed when idle, thick blue when dragging).
+   * Default: true (important for visual feedback and accessibility)
+   */
+  showDashedBorder?: boolean;
+};
+type FileDropzoneOverlayProps = Omit<FileDropzoneProps, 'helpTextAlignCenter' | 'hideErrors' | 'labelText'> & {
+  /** Content to wrap with the dropzone overlay - required for the component to have a visible drag area */children: React.ReactNode;
+  /**
+   * Whether to disable clicking through the overlay to interact with wrapped children when not dragging files.
+   * When false (default): Overlay is transparent to clicks, allowing interaction with wrapped content.
+   * When true: Overlay captures all events like a normal file uploader (opens file picker on click).
+   */
+  disableClickThrough?: boolean; /** Text to display in the overlay when actively dragging files over the component */
+  dragText?: string; /** Custom icon to display in the overlay during drag. If not provided, shows smart default based on accepted file types and maxFiles. */
+  icon?: React.ReactNode; /** Configuration for visual styling options during drag operations */
+  styleOptions?: OverlayStyleOptions;
+};
+type PreviewConfig = Omit<FilePreviewListProps, 'files' | 'onDelete' | 'previewStyle'>;
+type DropzoneConfig = Omit<FileDropzoneProps, 'files'>;
+type FileUploadProps = DropzoneConfig & {
+  /** Whether to hide the file preview list */hideFilePreview?: boolean; /** Initial files to populate the uploader with when first mounted */
+  initialFiles?: FileResource[]; /** Enables more granular custom configuration for the file preview list. (See FilePreviewList for available props) */
+  previewConfig?: PreviewConfig; /** Determines the view style for the file preview list */
+  previewStyle?: PreviewStyle;
+};
+type DropzoneOverlayConfig = Omit<FileDropzoneOverlayProps, 'children' | 'files'>;
+type FileUploadCanvasProps = DropzoneOverlayConfig & {
+  /** Initial files to populate the uploader with when first mounted */initialFiles?: FileResource[]; /** Enables more granular custom configuration for the file preview list. (See FilePreviewList for available props) */
+  previewConfig?: PreviewConfig; /** Determines the view style for the file preview list */
+  previewStyle?: PreviewStyle;
+};
+//#endregion
+//#region src/FileUpload/components/FileUpload/FileUpload.d.ts
+/**
+ * FileUpload component for handling single or multiple file uploads
+ * with built-in validation and preview capabilities.
+ *
+ * This is the main container component that combines the drag-and-drop area (FileDropzone)
+ * and the file preview list (FilePreviewList) into a single, cohesive interface.
+ * It handles the file validation, upload state management, and preview display through
+ * the FileUploadProvider context.
+ *
+ */
+declare const FileUpload: {
+  ({
+    disabled,
+    error,
+    hideFilePreview,
+    initialFiles,
+    maxFiles,
+    maxSize,
+    onDrop,
+    onDropAccepted,
+    onDropRejected,
+    onFileDelete,
+    previewConfig,
+    previewStyle,
+    ...dropzoneProps
+  }: FileUploadProps): import("react/jsx-runtime").JSX.Element;
+  displayName: string;
+};
+//#endregion
+//#region src/FileUpload/components/FileDropzoneOverlay/FileDropzoneOverlay.d.ts
+declare const FileDropzoneOverlay: {
+  ({
+    accept: acceptProp,
+    ariaLabel,
+    children,
+    className,
+    "data-testid": dataTestId,
+    disableClickThrough,
+    disabled: disabledProp,
+    disableDragValidation,
+    dragText,
+    error,
+    files: filesProp,
+    icon,
+    maxFiles: maxFilesProp,
+    maxSize: maxSizeProp,
+    onDrop: onDropProp,
+    onDropAccepted: onDropAcceptedProp,
+    onDropRejected: onDropRejectedProp,
+    onFilesChange: onFilesChangeProp,
+    showDebugger,
+    strictValidation,
+    styleOptions,
+    validator
+  }: FileDropzoneOverlayProps): import("react/jsx-runtime").JSX.Element;
+  displayName: string;
+};
+//#endregion
+//#region src/FileUpload/components/FileUploadCanvas/FileUploadCanvas.d.ts
+/**
+ * FileUploadCanvas component - An out-of-the-box solution for drag-and-drop file uploads
+ * with overlay-based interaction.
+ *
+ * This component wraps FilePreviewList with FileDropzoneOverlay, allowing users to drag
+ * files over existing content. The overlay appears during drag operations and provides
+ * visual feedback. It uses FileUploadProvider for state management.
+ *
+ * Key differences from FileUpload:
+ * - Uses FileDropzoneOverlay (overlay-based) instead of FileDropzone (dedicated area)
+ * - Supports disableClickThrough for interactive content underneath
+ * - Always shows FilePreviewList (no hideFilePreview option)
+ * - Ideal for gallery views and canvas-style interfaces
+ */
+declare const FileUploadCanvas: {
+  ({
+    className,
+    disabled,
+    error,
+    initialFiles,
+    maxFiles,
+    maxSize,
+    onDrop,
+    onDropAccepted,
+    onDropRejected,
+    onFileDelete,
+    previewConfig,
+    previewStyle,
+    ...dropzoneOverlayProps
+  }: FileUploadCanvasProps): import("react/jsx-runtime").JSX.Element;
+  displayName: string;
+};
+//#endregion
+//#region src/FileUpload/components/FileDropzone/FileDropzone.d.ts
+/**
+ * FileDropzone component for handling file uploads with drag and drop support.
+ * This is a versatile file input component that can work both as a standalone
+ * component or as part of the FileUpload system.
+ */
+/**
+ * Handles the dual-mode functionality of the FileDropzone component, supporting both standalone usage
+ * and provider-wrapped usage.
+ *
+ * ## Validation Modes
+ * - **Provider Mode**: Uses validation context from FileUploadProvider for coordinated validation across components
+ * - **Standalone Mode**: Creates local validation instance for independent operation
+ *
+ * ## Props & Context Resolution
+ * The component follows a specific precedence order for each property:
+ * 1. Direct props take highest priority (for granular control)
+ * 2. Context values serve as fallbacks (for coordinated state)
+ * 3. Default values as final fallbacks (for safety)
+ *
+ * This enables two key use cases:
+ * 1. Standalone Usage: <FileDropzone maxFiles={5} onDrop={handleDrop} />
+ * 2. Provider Usage:
+ *    <FileUploadProvider maxFiles={5}>
+ *      <FileDropzone /> // Inherits provider config
+ *      <FileDropzone maxFiles={1} /> // Overrides specific provider values
+ *    </FileUploadProvider>
+ */
+declare const FileDropzone: {
+  ({
+    accept: acceptProp,
+    ariaLabel,
+    className,
+    "data-testid": dataTestId,
+    disabled: disabledProp,
+    disableDragValidation,
+    error,
+    files: filesProp,
+    helpText,
+    helpTextAlignCenter,
+    hideErrors,
+    hideHelpText,
+    labelText,
+    maxFiles: maxFilesProp,
+    maxSize: maxSizeProp,
+    onDrop: onDropProp,
+    onDropAccepted: onDropAcceptedProp,
+    onDropRejected: onDropRejectedProp,
+    onFilesChange: onFilesChangeProp,
+    showDebugger,
+    strictValidation,
+    validator
+  }: FileDropzoneProps): import("react/jsx-runtime").JSX.Element;
+  displayName: string;
+};
+//#endregion
+//#region src/FileUpload/components/FileCard/FileCard.d.ts
+type FileCardProps = BaseFileCardProps & {
+  badge?: string;
+  cardStyle?: BaseFileCardStyle;
+  'data-testid'?: string;
+  showActionsOnHover?: boolean;
+  statusText?: string;
+};
+declare const FileCard: {
+  ({
+    badge,
+    cardStyle,
+    "data-testid": dataTestId,
+    errorMessage,
+    progress,
+    showActionsOnHover,
+    status,
+    statusIcon,
+    statusText,
+    ...props
+  }: FileCardProps): import("react/jsx-runtime").JSX.Element;
+  displayName: string;
+};
+//#endregion
+//#region src/FileUpload/components/ListFileCard/ListFileCard.d.ts
+type ListFileCardProps = BaseFileCardProps & {
+  cardStyle?: ListFileCardStyle;
+  'data-testid'?: string;
+  showActionsOnHover?: boolean;
+  statusText?: string;
+};
+declare const ListFileCard: {
+  ({
+    actions,
+    cardStyle,
+    className,
+    "data-testid": dataTestId,
+    draggable,
+    errorMessage,
+    fileName,
+    hideFileName,
+    hideFileSize,
+    hideFileStatus,
+    imageSource,
+    isSelected,
+    onDelete,
+    onImageError,
+    onSelect,
+    progress,
+    selectable,
+    showActionsOnHover,
+    status,
+    statusIcon,
+    statusText
+  }: ListFileCardProps): import("react/jsx-runtime").JSX.Element;
+  displayName: string;
+};
+//#endregion
+//#region src/FileUpload/components/GridFileCard/GridFileCard.d.ts
+type GridViewProps = BaseFileCardProps & {
+  badge?: string;
+  'data-testid'?: string;
+  statusText?: string;
+};
+declare const GridFileCard: {
+  ({
+    actions,
+    badge,
+    className,
+    "data-testid": dataTestId,
+    draggable,
+    errorMessage,
+    fileName,
+    hideFileName,
+    hideFileSize,
+    hideFileStatus,
+    imageSource,
+    isSelected,
+    onDelete,
+    onImageError,
+    onSelect,
+    progress,
+    selectable,
+    sortable,
+    status,
+    statusIcon,
+    statusText
+  }: GridViewProps): import("react/jsx-runtime").JSX.Element;
+  displayName: string;
+};
+//#endregion
+//#region src/FileUpload/utils/getFileExtensionsFromAcceptedTypes.d.ts
+/**
+ * Converts file type restrictions into a comma-separated list of file extensions
+ * @param accept - Optional file type restrictions, can be either:
+ *   - A preset category from CommonFileTypes (e.g., 'images', 'pdfs', 'documents')
+ *   - An array of specific file extensions (e.g., ['.jpg', '.png', '.pdf'])
+ *   - An array of MIME types (e.g., ['image/jpeg', 'image/png', 'application/pdf'])
+ *   - A mixed array of both extensions and MIME types
+ * @returns A comma-separated string of file extensions with leading dots (e.g., '.jpg, .png, .pdf')
+ *          or an empty string if no valid extensions are found or accept is undefined
+ * @example
+ * // Returns '.jpeg, .png, .gif, .webp, .jpg'
+ * getFileExtensionsFromAcceptedTypes('images')
+ *
+ * // Returns '.jpg, .png, .pdf'
+ * getFileExtensionsFromAcceptedTypes(['.jpg', 'image/png', 'application/pdf'])
+ */
+declare const getFileExtensionsFromAcceptedTypes: (accept?: CommonFileTypes | string[]) => string;
+//#endregion
+//#region src/FileUpload/utils/getFilePluralizationText.d.ts
+type GetFilePluralizationTextProps = {
+  accept?: CommonFileTypes | string[];
+  capitalize?: boolean;
+  count?: number;
+  hideCount?: boolean;
+};
+/**
+ * Generates a formatted text string for file type descriptions with proper pluralization and capitalization
+ * @param props Configuration object for text formatting
+ * @param props.accept - Optional file type(s) to determine if text should say "file" or "image"
+ * @param props.capitalize - Optional flag to capitalize the first letter of the output
+ * @param props.count - Optional number to determine pluralization (e.g., "1 file" vs "2 files")
+ * @param props.hideCount - Optional flag to exclude the count from the output (e.g., "files" instead of "2 files")
+ * @returns Formatted string describing file(s) or image(s)
+ * @example
+ * // Returns "2 files"
+ * getFilePluralizationText({ count: 2 })
+ *
+ * // Returns "1 image"
+ * getFilePluralizationText({ accept: 'images', count: 1 })
+ *
+ * // Returns "Files"
+ * getFilePluralizationText({ capitalize: true, hideCount: true })
+ *
+ * // Returns "Image"
+ * getFilePluralizationText({ accept: 'images', capitalize: true })
+ */
+declare const getFilePluralizationText: ({
+  accept,
+  capitalize: capitalizeWord,
+  count,
+  hideCount
+}?: GetFilePluralizationTextProps) => string;
+//#endregion
+export { FileCard as a, FileDropzoneOverlay as c, FilePreviewList as d, FileCardAction as f, FileStatusIconConfig as g, FileStatusIcon as h, ListFileCard as i, FileUpload as l, FileStatusConfig as m, getFileExtensionsFromAcceptedTypes as n, FileDropzone as o, FileProgressCircleConfig as p, GridFileCard as r, FileUploadCanvas as s, getFilePluralizationText as t, OverlayStyleOptions as u };
+//# sourceMappingURL=index-B-GVogfk2.d.mts.map

package/index-B-GVogfk2.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-B-GVogfk2.d.mts","names":[],"sources":["../src/FileUpload/components/types.ts","../src/FileUpload/components/FilePreviewList/FilePreviewList.tsx","../src/FileUpload/types/sharedTypes.ts","../src/FileUpload/components/FileUpload/FileUpload.tsx","../src/FileUpload/components/FileDropzoneOverlay/FileDropzoneOverlay.tsx","../src/FileUpload/components/FileUploadCanvas/FileUploadCanvas.tsx","../src/FileUpload/components/FileDropzone/FileDropzone.tsx","../src/FileUpload/components/FileCard/FileCard.tsx","../src/FileUpload/components/ListFileCard/ListFileCard.tsx","../src/FileUpload/components/GridFileCard/GridFileCard.tsx","../src/FileUpload/utils/getFileExtensionsFromAcceptedTypes.ts","../src/FileUpload/utils/getFilePluralizationText.ts"],"mappings":";;;;;;;;;;KAYY,cAAA;EACR,IAAA,EAAM,OAAA;EACN,SAAA,GAAY,SAAA;EACZ,IAAA;EACA,OAAA,GAAU,CAAA,EAAG,KAAA,CAAM,UAAA,CAAW,WAAA,GAAc,YAAA,EAAc,YAAA;AAAA;AAAA,KAGlD,oBAAA;EACR,KAAA,GAAQ,SAAA;EACR,IAAA,EAAM,OAAA,UAAiB,cAAA;EACvB,KAAA,GAAQ,SAAA;EACR,IAAA;AAAA;AAAA,KAGQ,wBAAA;EACR,UAAA,GAAa,cAAA,QAAsB,cAAA;EACnC,KAAA,GAAQ,cAAA,QAAsB,cAAA;EAC9B,sBAAA,GAAyB,cAAA,QAAsB,cAAA;EAC/C,IAAA;AAAA;AAAA,KAGQ,cAAA,GAAiB,oBAAA,GAAuB,wBAAwB;AAAA,KAEhE,gBAAA;EACR,YAAA;EACA,QAAA;EACA,MAAA;EACA,UAAA,GAAa,cAAc;EAC3B,UAAA;AAAA;AAAA,KAGQ,YAAA;AAAA,KACA,iBAAA;AAAA,KACA,iBAAA;AAAA,KAEA,iBAAA;EA3BA;;;;EAgCR,OAAA,GAAU,cAAA;EACV,SAAA;EACA,SAAA;EACA,YAAA;EACA,QAAA;EACA,YAAA;EACA,YAAA;EACA,cAAA;EACA,WAAA,EAAa,YAAA;EACb,UAAA;EACA,QAAA,IAAY,YAAA,EAAc,YAAA;EAC1B,YAAA,IAAgB,YAAA,EAAc,YAAA;EAC9B,QAAA,IAAY,YAAA,EAAc,YAAA,EAAc,UAAA,oBAtCR;EAwChC,QAAA;EACA,UAAA;EACA,QAAA;IACI,UAAA,GAAa,mBAAA;IACb,UAAA;IACA,SAAA,GAAY,oBAAA;IACZ,UAAA,GAAa,IAAA,EAAM,WAAA;IACnB,MAAA,GAAS,aAAA;EAAA;EAEb,MAAA;EACA,UAAA,GAAa,cAAA;AAAA;EACV,UAAA;EAAqB,UAAA;AAAA;EAAuB,UAAA;EAAsB,UAAA;AAAA;;;KCjEpE,gBAAA;EACD,EAAA;AAAA;AAAA,KAGQ,oBAAA;+DAER,oBAAA;EAEA,SAAA,WDRsB;ECUtB,gBAAA,GAAmB,gBAAA,EDTb;ECWN,aAAA,WDR8B;ECU9B,SAAA,YDV0D;ECY1D,KAAA,GAAQ,YAAA,IDZ8D;ECctE,mBAAA,IAAuB,IAAA,EAAM,YAAA,EAAc,KAAA,aAAkB,gBAAA,cDjBvD;ECmBN,gBAAA,YDlBY;ECoBZ,aAAA,YDlBA;ECoBA,aAAA,YDpBmB;ECsBnB,gBAAA,YDtBU;ECwBV,QAAA,IAAY,YAAA,EAAc,YAAA,WDxBkB;EC0B5C,QAAA,IAAY,YAAA,EAAc,YAAA,EAAc,UAAA,oBD1B8B;EC4BtE,YAAA,GAAe,YAAA,EDzBa;EC2B5B,kBAAA,YD1BQ;EC4BR,WAAA;AAAA;AAAA,cASS,eAAA;EAAA;;;;;;;;;;;;;;;;;KAiBV,oBAAA,+BAAoB,GAAA,CAAA,OAAA;;;;;;;;AD9DvB;KECK,eAAA;yDAED,qBAAA,YFDY;EEGZ,QAAA,YFDa;EEGb,KAAA,GAAQ,SAAA,EFH8D;EEKtE,UAAA,YFRA;EEUA,QAAA,WFTA;EEWA,OAAA,WFVA;EEYA,MAAA,IAAU,aAAA,EAAe,IAAA,IAAQ,aAAA,EAAe,aAAA,aFXnC;EEab,cAAA,IAAkB,KAAA,EAAO,IAAA;EFbK;;;;EEkB9B,cAAA,IAAkB,aAAA,EAAe,aAAA;EFlBqC;AAG1E;;EEmBI,YAAA,IAAgB,YAAA,EAAc,YAAA,WFlBtB;EEoBR,aAAA,IAAiB,KAAA,EAAO,YAAA,aFnBD;EEqBvB,YAAA,YFpBiB;EEsBjB,gBAAA;AAAA;;;;;KAOC,OAAA;EF7BO,mDE+BR,SAAA,WF9BI;EEgCJ,aAAA,WF7BQ;EE+BR,QAAA;EAEA,mBAAA,YFhCa;EEkCb,YAAA,YFjCQ;EEmCR,SAAA;AAAA;;;;;KAOC,iBAAA;EF1CD,yEE4CA,MAAA,GAAS,eAAA,aF5CqB;EE8C9B,SAAA,WF7CyB;EE+CzB,SAAA,GAAY,aAAa;AAAA;;AF9CrB;AAGR;;KEkDY,iBAAA,GAAoB,eAAA,GAC5B,OAAA,GACA,iBAAA;EFpDyB;AAA+C;EEuDpE,KAAA,GAAQ,YAAA;AAAA;AAAA,KAGJ,mBAAA;EFpDmB,sFEsD3B,UAAA;EFxDA;;;;;EE8DA,UAAA;EF3DU;AAGd;;;EE6DI,YAAA;EF7DoB;AACxB;;;EEiEI,gBAAA;AAAA;AAAA,KAGQ,wBAAA,GAA2B,IAAA,CAAK,iBAAA;EFnEf,yGEqEzB,QAAA,EAAU,KAAA,CAAM,SAAA;EFrES;AAAA;AAE7B;;;EEyEI,mBAAA,YF5Da;EE8Db,QAAA,WF3D8B;EE6D9B,IAAA,GAAO,KAAA,CAAM,SAAA,EFvDI;EEyDjB,YAAA,GAAe,mBAAA;AAAA;AAAA,KAId,aAAA,GAAgB,IAAI,CAAC,oBAAA;AAAA,KAGrB,cAAA,GAAiB,IAAI,CAAC,iBAAA;AAAA,KAGf,eAAA,GAAkB,cAAA;EF5DC,4CE8D3B,eAAA,YFtFU;EEwFV,YAAA,GAAe,YAAA,IFtFf;EEwFA,aAAA,GAAgB,aAAA,EFtFhB;EEwFA,YAAA,GAAe,YAAA;AAAA;AAAA,KAId,qBAAA,GAAwB,IAAI,CAAC,wBAAA;AAAA,KAGtB,qBAAA,GAAwB,qBAAA;EF3FnB,qEE6Fb,YAAA,GAAe,YAAA,IF3Ff;EE6FA,aAAA,GAAgB,aAAA,EF7FJ;EE+FZ,YAAA,GAAe,YAAA;AAAA;;;;;;;;;;;;;cC7IN,UAAA;EAAA;;;;;;;;;;;;;;KAcV,eAAA,+BAAe,GAAA,CAAA,OAAA;;;;;cCdL,mBAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;KAuBV,wBAAA,+BAAwB,GAAA,CAAA,OAAA;;;;;;;;;;;;;;;AJ3B3B;;;;cKgEa,gBAAA;EAAA;;;;;;;;;;;;;;KAcV,qBAAA,+BAAqB,GAAA,CAAA,OAAA;;;;;;;;;;;;;;;AL9ExB;;;;;;;;;;;;;;;;;cMkCa,YAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;KAuBV,iBAAA,+BAAiB,GAAA,CAAA,OAAA;;;;;KCjER,aAAA,GAAgB,iBAAA;EACxB,KAAA;EACA,SAAA,GAAY,iBAAiB;EAC7B,aAAA;EACA,kBAAA;EACA,UAAA;AAAA;AAAA,cAGS,QAAA;EAAA;;;;;;;;;;;KAWV,aAAA,+BAAa,GAAA,CAAA,OAAA;;;;;KCXJ,iBAAA,GAAoB,iBAAA;EAC5B,SAAA,GAAY,iBAAiB;EAC7B,aAAA;EACA,kBAAA;EACA,UAAA;AAAA;AAAA,cAGS,YAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;KAsBV,iBAAA,+BAAiB,GAAA,CAAA,OAAA;;;;;KC1Bf,aAAA,GAAgB,iBAAiB;EAClC,KAAA;EACA,aAAA;EACA,UAAA;AAAA;AAAA,cASS,YAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;KAsBV,aAAA,+BAAa,GAAA,CAAA,OAAA;;;;;;;;ATrChB;;;;;;;;;;;;;cU2Ca,kCAAA,GAAsC,MAAmC,GAA1B,eAAe;;;KCnDtE,6BAAA;EACD,MAAA,GAAS,eAAe;EACxB,UAAA;EACA,KAAA;EACA,SAAA;AAAA;;;;;AXIJ;;;;;;;;;;;;;;;;;cWuCa,wBAAA;EAA4B,MAAA;EAAA,UAAA,EAAA,cAAA;EAAA,KAAA;EAAA;AAAA,IAKtC,6BAAA"}