@zvoove/unity-ui 2.29.1 → 2.32.1

package/dist/src/components/Uploader/components/DropZone/DropZone.styled.d.ts

@@ -0,0 +1,68 @@
+export declare const dropZoneStyles: import('tailwind-variants').TVReturnType<{
+    isDragOver: {
+        true: string[];
+        false: never[];
+    };
+    isProcessing: {
+        true: string[];
+        false: never[];
+    };
+    disabled: {
+        true: string[];
+        false: string[];
+    };
+    supportsDrag: {
+        true: never[];
+        false: never[];
+    };
+}, undefined, string[], {
+    isDragOver: {
+        true: string[];
+        false: never[];
+    };
+    isProcessing: {
+        true: string[];
+        false: never[];
+    };
+    disabled: {
+        true: string[];
+        false: string[];
+    };
+    supportsDrag: {
+        true: never[];
+        false: never[];
+    };
+}, undefined, import('tailwind-variants').TVReturnType<{
+    isDragOver: {
+        true: string[];
+        false: never[];
+    };
+    isProcessing: {
+        true: string[];
+        false: never[];
+    };
+    disabled: {
+        true: string[];
+        false: string[];
+    };
+    supportsDrag: {
+        true: never[];
+        false: never[];
+    };
+}, undefined, string[], unknown, unknown, undefined>>;
+export declare const browseLinkStyles: import('tailwind-variants').TVReturnType<{
+    disabled: {
+        true: string[];
+        false: string[];
+    };
+}, undefined, string[], {
+    disabled: {
+        true: string[];
+        false: string[];
+    };
+}, undefined, import('tailwind-variants').TVReturnType<{
+    disabled: {
+        true: string[];
+        false: string[];
+    };
+}, undefined, string[], unknown, unknown, undefined>>;

package/dist/src/components/Uploader/components/DropZone/index.d.ts

@@ -0,0 +1 @@
+export { default as DropZone } from './DropZone';

package/dist/src/components/Uploader/components/FileItem/FileItem.d.ts

@@ -0,0 +1,18 @@
+import { default as React } from 'react';
+import { FileItem as FileItemType } from '../../types';
+/**
+ * Props for the FileItem component.
+ */
+export interface FileItemProps {
+    /**
+     * The file item data to display.
+     */
+    fileItem: FileItemType;
+    /**
+     * Whether this specific file can be deleted.
+     * Overrides the context-level canDeleteFile setting.
+     */
+    canDeleteFile?: boolean;
+}
+declare const FileItem: ({ fileItem, canDeleteFile, }: FileItemProps) => React.JSX.Element;
+export default FileItem;

package/dist/src/components/Uploader/components/FileItem/FileItem.styled.d.ts

@@ -0,0 +1,67 @@
+export declare const fileItemStyles: import('tailwind-variants').TVReturnType<{
+    isError: {
+        true: string[];
+        false: string[];
+    };
+    disabled: {
+        true: string[];
+        false: never[];
+    };
+}, undefined, string[], {
+    isError: {
+        true: string[];
+        false: string[];
+    };
+    disabled: {
+        true: string[];
+        false: never[];
+    };
+}, undefined, import('tailwind-variants').TVReturnType<{
+    isError: {
+        true: string[];
+        false: string[];
+    };
+    disabled: {
+        true: string[];
+        false: never[];
+    };
+}, undefined, string[], unknown, unknown, undefined>>;
+export declare const fileItemHeaderStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const fileItemIconStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const fileItemContentStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const fileItemRowStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const fileItemTextContainerStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const fileItemNameStyles: import('tailwind-variants').TVReturnType<{
+    isError: {
+        true: string[];
+        false: string[];
+    };
+    disabled: {
+        true: string[];
+        false: never[];
+    };
+}, undefined, never[], {
+    isError: {
+        true: string[];
+        false: string[];
+    };
+    disabled: {
+        true: string[];
+        false: never[];
+    };
+}, undefined, import('tailwind-variants').TVReturnType<{
+    isError: {
+        true: string[];
+        false: string[];
+    };
+    disabled: {
+        true: string[];
+        false: never[];
+    };
+}, undefined, never[], unknown, unknown, undefined>>;
+export declare const fileItemNameWrapperStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const fileItemMetadataStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const fileItemActionsStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const fileItemCancelButtonDesktopStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const fileItemCancelButtonMobileStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const fileItemProgressContainerStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;

package/dist/src/components/Uploader/components/FileItem/index.d.ts

@@ -0,0 +1,2 @@
+export { default as FileItem } from './FileItem';
+export type { FileItemProps } from './FileItem';

package/dist/src/components/Uploader/components/FileItem/useFileItem.d.ts

@@ -0,0 +1,33 @@
+import { FileIconNames } from '../../../../index.ts';
+import { useUploaderContext } from '../../hooks';
+import { FileItem as FileItemType } from '../../types';
+interface UseFileItemOptions {
+    fileItem: FileItemType;
+    canDeleteFile?: boolean;
+}
+interface MetadataContent {
+    text: string;
+    color: 'error' | 'on-surface-variant';
+    role?: 'alert';
+    testId: string;
+}
+interface UseFileItemReturn {
+    file: File;
+    id: string;
+    fileExtension: string;
+    progress: number | undefined;
+    labels: ReturnType<typeof useUploaderContext>['labels'];
+    fileIconName: FileIconNames;
+    metadata: MetadataContent;
+    isError: boolean;
+    shouldShowProgress: boolean;
+    showCancelButton: boolean;
+    showRetryButton: boolean;
+    shouldShowDeleteButton: boolean;
+    disabled: boolean;
+    handleRemove: () => void;
+    handleCancel: () => void;
+    handleRetry: () => void;
+}
+declare const useFileItem: ({ fileItem, canDeleteFile: canDeleteFileProp, }: UseFileItemOptions) => UseFileItemReturn;
+export default useFileItem;

package/dist/src/components/Uploader/components/FileList/FileList.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+/**
+ * Props for the FileList component.
+ */
+export interface FileListProps {
+    /**
+     * Additional CSS classes to apply to the file list.
+     */
+    className?: string;
+}
+declare const FileList: ({ className }: FileListProps) => React.JSX.Element | null;
+export default FileList;

package/dist/src/components/Uploader/components/FileList/FileList.styled.d.ts

@@ -0,0 +1 @@
+export declare const fileListStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;

package/dist/src/components/Uploader/components/FileList/index.d.ts

@@ -0,0 +1,2 @@
+export { default as FileList } from './FileList';
+export type { FileListProps } from './FileList';

package/dist/src/components/Uploader/components/RejectionList/RejectionList.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+/**
+ * Props for the RejectionList component.
+ */
+export interface RejectionListProps {
+    /**
+     * Additional CSS classes to apply to the rejection list.
+     */
+    className?: string;
+}
+declare const RejectionList: ({ className, }: RejectionListProps) => React.JSX.Element | null;
+export default RejectionList;

package/dist/src/components/Uploader/components/RejectionList/RejectionList.styled.d.ts

@@ -0,0 +1,10 @@
+export declare const rejectionListContainerStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const rejectionListContentStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const rejectionListErrorGroupsContainerStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const rejectionListErrorGroupStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const rejectionListErrorGroupContentStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const rejectionListErrorHeaderStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const rejectionListFileListStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const rejectionListFileNameStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const rejectionListActionsStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+export declare const rejectionListToggleButtonStyles: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;

package/dist/src/components/Uploader/components/RejectionList/index.d.ts

@@ -0,0 +1,2 @@
+export { default as RejectionList } from './RejectionList';
+export type { RejectionListProps } from './RejectionList';

package/dist/src/components/Uploader/components/index.d.ts

@@ -0,0 +1,5 @@
+export * from './Announcer';
+export * from './FileItem';
+export * from './FileList';
+export * from './DropZone';
+export * from './RejectionList';

package/dist/src/components/Uploader/hooks/index.d.ts

@@ -0,0 +1,11 @@
+export { default as useUploaderState } from './useUploaderState';
+export { default as useFileInput } from './useFileInput';
+export { default as useDragAndDrop } from './useDragAndDrop';
+export { default as useValidation } from './useValidation';
+export { default as useAnnouncements } from './useAnnouncements';
+export { default as useUploaderContext } from './useUploaderContext';
+export { default as useFileSelection } from './useFileSelection';
+export { default as useFileOperations } from './useFileOperations';
+export { default as useUploaderRef } from './useUploaderRef';
+export { default as useFileUpload } from './useFileUpload';
+export type { UploadFunction } from './useFileUpload';

package/dist/src/components/Uploader/hooks/useAnnouncements.d.ts

@@ -0,0 +1,10 @@
+import { AnnouncementType } from '../types';
+interface UseAnnouncementsOptions {
+    getAnnouncement?: (type: AnnouncementType, data: Record<string, unknown>) => string;
+}
+interface UseAnnouncementsReturn {
+    announcement: string;
+    announce: (type: AnnouncementType, data: Record<string, unknown>) => void;
+}
+declare const useAnnouncements: ({ getAnnouncement, }?: UseAnnouncementsOptions) => UseAnnouncementsReturn;
+export default useAnnouncements;

package/dist/src/components/Uploader/hooks/useDragAndDrop.d.ts

@@ -0,0 +1,17 @@
+import { DragEvent } from 'react';
+import { FileSource } from '../types';
+interface UseDragAndDropOptions {
+    disabled?: boolean;
+    onFilesSelected: (files: File[], source: FileSource) => void;
+}
+interface UseDragAndDropReturn {
+    isDragging: boolean;
+    dragHandlers: {
+        onDragEnter: (event: DragEvent) => void;
+        onDragOver: (event: DragEvent) => void;
+        onDragLeave: (event: DragEvent) => void;
+        onDrop: (event: DragEvent) => void;
+    };
+}
+declare const useDragAndDrop: ({ disabled, onFilesSelected, }: UseDragAndDropOptions) => UseDragAndDropReturn;
+export default useDragAndDrop;

package/dist/src/components/Uploader/hooks/useFileInput.d.ts

@@ -0,0 +1,19 @@
+import { ChangeEvent, FormEvent } from 'react';
+import { FileItem, FileSource } from '../types';
+interface UseFileInputOptions {
+    accept?: string;
+    multiple?: boolean;
+    disabled?: boolean;
+    onFilesSelected: (files: File[], source: FileSource) => void;
+    files?: FileItem[];
+    required?: boolean;
+    requiredErrorMessage?: string;
+}
+interface UseFileInputReturn {
+    inputRef: React.RefObject<HTMLInputElement | null>;
+    openPicker: () => void;
+    handleChange: (event: ChangeEvent<HTMLInputElement>) => void;
+    handleInvalid: (event: FormEvent<HTMLInputElement>) => void;
+}
+declare const useFileInput: ({ accept, multiple, disabled, onFilesSelected, files, required, requiredErrorMessage, }: UseFileInputOptions) => UseFileInputReturn;
+export default useFileInput;

package/dist/src/components/Uploader/hooks/useFileOperations.d.ts

@@ -0,0 +1,18 @@
+import { ChangeEvent, FileItem, FileState } from '../types';
+interface UseFileOperationsOptions {
+    disabled?: boolean;
+    files: FileItem[];
+    isControlled: boolean;
+    onChange?: (event: ChangeEvent) => void;
+    removeFileInternal: (id: string) => void;
+    clearAllInternal: () => void;
+    updateFileStateInternal: (id: string, state: Partial<FileState>) => void;
+    announce: (type: 'added' | 'removed' | 'cleared' | 'component-error' | 'count-changed', data: Record<string, unknown>) => void;
+}
+interface UseFileOperationsReturn {
+    handleRemoveFile: (id: string) => void;
+    handleClearAll: () => void;
+    handleUpdateFileState: (id: string, state: Partial<FileState>) => void;
+}
+declare const useFileOperations: ({ disabled, files, isControlled, onChange, removeFileInternal, clearAllInternal, updateFileStateInternal, announce, }: UseFileOperationsOptions) => UseFileOperationsReturn;
+export default useFileOperations;

package/dist/src/components/Uploader/hooks/useFileSelection.d.ts

@@ -0,0 +1,36 @@
+import { COMPONENT_ERROR, ChangeEvent, FILE_ERROR, FileItem, FileSource, RejectedFile, ValidationEvent } from '../types';
+interface UseFileSelectionOptions {
+    disabled?: boolean;
+    files: FileItem[];
+    selectionMode: 'append' | 'replace';
+    validateFiles: (newFiles: File[], existingFiles: FileItem[], selectionMode: 'append' | 'replace') => {
+        fileResults: Array<{
+            file: File;
+            isValid: boolean;
+            error?: FILE_ERROR;
+            errorMessage?: string;
+        }>;
+        componentErrors: Array<{
+            code: COMPONENT_ERROR;
+            message: string;
+        }>;
+        isValid: boolean;
+    };
+    setProcessing: (isProcessing: boolean, processingId?: string | null) => void;
+    setComponentError: (error: {
+        code: COMPONENT_ERROR;
+        message: string;
+    } | null) => void;
+    announce: (type: 'added' | 'removed' | 'cleared' | 'component-error' | 'count-changed', data: Record<string, unknown>) => void;
+    isControlled: boolean;
+    onChange?: (event: ChangeEvent) => void;
+    onValidation?: (event: ValidationEvent) => void;
+    addFilesInternal: (files: FileItem[]) => void;
+    replaceFilesInternal: (files: FileItem[]) => void;
+    addRejectedFiles: (rejectedFiles: RejectedFile[]) => void;
+}
+interface UseFileSelectionReturn {
+    handleFilesSelected: (selectedFiles: File[], source: FileSource) => void;
+}
+declare const useFileSelection: ({ disabled, files, selectionMode, validateFiles, setProcessing, setComponentError, announce, isControlled, onChange, onValidation, addFilesInternal, replaceFilesInternal, addRejectedFiles, }: UseFileSelectionOptions) => UseFileSelectionReturn;
+export default useFileSelection;

package/dist/src/components/Uploader/hooks/useFileUpload.d.ts

@@ -0,0 +1,66 @@
+import { RefObject } from 'react';
+import { UploaderRef } from '../Uploader.types';
+import { FileItem } from '../types';
+/**
+ * Function that performs the actual file upload.
+ * @param file - The file to upload
+ * @param onProgress - Callback to report upload progress (0-100)
+ * @param signal - AbortSignal for cancellation support
+ * @returns Promise that resolves on success or rejects on error
+ */
+export type UploadFunction = (file: File, onProgress?: (progress: number) => void, signal?: AbortSignal) => Promise<void>;
+interface UseFileUploadOptions {
+    /**
+     * Reference to the Uploader component instance.
+     * Used to update file states during upload.
+     */
+    uploaderRef: RefObject<UploaderRef | null>;
+    /**
+     * Function that performs the actual upload.
+     * Should handle progress reporting and cancellation.
+     */
+    uploadFunction: UploadFunction;
+    /**
+     * Optional callback fired when an upload succeeds.
+     * @param fileId - The ID of the file that succeeded
+     */
+    onUploadSuccess?: (fileId: string) => void;
+    /**
+     * Optional callback fired when an upload fails.
+     * @param fileId - The ID of the file that failed
+     * @param error - The error that occurred
+     */
+    onUploadError?: (fileId: string, error: Error) => void;
+    /**
+     * Optional callback fired when an upload is canceled.
+     * @param fileId - The ID of the file that was canceled
+     */
+    onUploadCancel?: (fileId: string) => void;
+}
+interface UseFileUploadReturn {
+    /**
+     * Uploads a file item.
+     * Updates the file state through the uploader ref.
+     * @param fileItem - The file item to upload
+     */
+    uploadFile: (fileItem: FileItem) => Promise<void>;
+    /**
+     * Cancels an active upload.
+     * @param fileId - The ID of the file to cancel
+     */
+    cancelUpload: (fileId: string) => void;
+    /**
+     * Retries a failed upload.
+     * Resets the file state and starts a new upload.
+     * @param fileItem - The file item to retry
+     */
+    retryUpload: (fileItem: FileItem) => Promise<void>;
+    /**
+     * Checks if a file is currently uploading.
+     * @param fileId - The ID of the file to check
+     * @returns True if the file is uploading, false otherwise
+     */
+    isUploading: (fileId: string) => boolean;
+}
+declare const useFileUpload: ({ uploaderRef, uploadFunction, onUploadSuccess, onUploadError, onUploadCancel, }: UseFileUploadOptions) => UseFileUploadReturn;
+export default useFileUpload;

package/dist/src/components/Uploader/hooks/useUploaderContext.d.ts

@@ -0,0 +1,3 @@
+import { UploaderContextValue } from '../Uploader.context';
+declare const useUploaderContext: () => UploaderContextValue;
+export default useUploaderContext;

package/dist/src/components/Uploader/hooks/useUploaderRef.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+import { UploaderRef } from '..';
+import { FileState } from '../types';
+interface UseUploaderRefOptions {
+    ref: React.ForwardedRef<UploaderRef>;
+    inputRef: React.RefObject<HTMLInputElement | null>;
+    openPicker: () => void;
+    handleClearAll: () => void;
+    handleUpdateFileState: (id: string, state: Partial<FileState>) => void;
+    handleRemoveFile: (id: string) => void;
+}
+declare const useUploaderRef: ({ ref, inputRef, openPicker, handleClearAll, handleUpdateFileState, handleRemoveFile, }: UseUploaderRefOptions) => void;
+export default useUploaderRef;

package/dist/src/components/Uploader/hooks/useUploaderState.d.ts

@@ -0,0 +1,30 @@
+import { COMPONENT_ERROR, FileItem, FileState, RejectedFile } from '../types';
+interface UploaderState {
+    files: FileItem[];
+    isProcessing: boolean;
+    processingId: string | null;
+    componentError: {
+        code: COMPONENT_ERROR;
+        message: string;
+    } | null;
+    rejectedFiles: RejectedFile[];
+}
+interface UseUploaderStateOptions {
+    initialFiles?: FileItem[];
+}
+declare const useUploaderState: ({ initialFiles, }?: UseUploaderStateOptions) => {
+    state: UploaderState;
+    addFiles: (files: FileItem[]) => void;
+    removeFile: (id: string) => void;
+    replaceFiles: (files: FileItem[]) => void;
+    clearAll: () => void;
+    updateFileState: (id: string, fileState: Partial<FileState>) => void;
+    setProcessing: (isProcessing: boolean, processingId?: string | null) => void;
+    setComponentError: (error: {
+        code: COMPONENT_ERROR;
+        message: string;
+    } | null) => void;
+    addRejectedFiles: (rejectedFiles: RejectedFile[]) => void;
+    clearRejectedFiles: () => void;
+};
+export default useUploaderState;

package/dist/src/components/Uploader/hooks/useValidation.d.ts

@@ -0,0 +1,30 @@
+import { DEFAULT_LABELS } from '../Uploader.constants';
+import { COMPONENT_ERROR, FILE_ERROR, FileItem } from '../types';
+interface ValidationOptions {
+    accept?: string;
+    maxFileSize?: number;
+    maxTotalSize?: number;
+    maxCount?: number;
+    minCount?: number;
+    labels?: typeof DEFAULT_LABELS;
+    getFileErrorMessage?: (error: FILE_ERROR, file: File) => string;
+    getComponentErrorMessage?: (error: COMPONENT_ERROR, data: Record<string, unknown>) => string;
+}
+interface FileValidationResult {
+    file: File;
+    isValid: boolean;
+    error?: FILE_ERROR;
+    errorMessage?: string;
+}
+interface ValidationResult {
+    fileResults: FileValidationResult[];
+    componentErrors: Array<{
+        code: COMPONENT_ERROR;
+        message: string;
+    }>;
+    isValid: boolean;
+}
+declare const useValidation: (options: ValidationOptions) => {
+    validateFiles: (newFiles: File[], existingFiles: FileItem[], selectionMode: "append" | "replace") => ValidationResult;
+};
+export default useValidation;

package/dist/src/components/Uploader/index.d.ts

@@ -0,0 +1,6 @@
+export { default as Uploader } from './Uploader';
+export * from './Uploader.types';
+export * from './types';
+export { UploaderProvider } from './Uploader.context';
+export type { UploaderContextValue, UploaderProviderProps, } from './Uploader.context';
+export { DEFAULT_LABELS, DEFAULT_ANNOUNCEMENTS } from './Uploader.constants';

package/dist/src/components/Uploader/types/errors.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Error types that can occur for individual files during validation.
+ */
+export declare enum FILE_ERROR {
+    /** File size exceeds the maxFileSize limit. */
+    FILE_TOO_LARGE = "file-too-large",
+    /** File type does not match the accepted types. */
+    INVALID_TYPE = "invalid-type",
+    /** File has zero bytes. */
+    EMPTY_FILE = "empty-file",
+    /** Adding this file would exceed the maxCount limit. */
+    MAX_COUNT_EXCEEDED = "max-count-exceeded",
+    /** File is a duplicate of an existing file. */
+    DUPLICATE_FILE = "duplicate-file"
+}
+/**
+ * Error types that affect the component as a whole.
+ */
+export declare enum COMPONENT_ERROR {
+    /** Total size of all files exceeds maxTotalSize. */
+    TOTAL_SIZE_EXCEEDED = "total-size-exceeded",
+    /** Number of files exceeds maxCount. */
+    MAX_COUNT_EXCEEDED = "max-count-exceeded",
+    /** Number of files is below minCount. */
+    MIN_COUNT_NOT_MET = "min-count-not-met",
+    /** A duplicate file was detected. */
+    DUPLICATE_FILE = "duplicate-file"
+}

package/dist/src/components/Uploader/types/events.d.ts

@@ -0,0 +1,65 @@
+import { COMPONENT_ERROR, FILE_ERROR } from './errors';
+import { FileItem } from './file';
+/**
+ * Event emitted when files are changed (added, removed, replaced, or cleared).
+ */
+export interface ChangeEvent {
+    /**
+     * The type of change that occurred.
+     */
+    action: 'add' | 'remove' | 'replace' | 'clear';
+    /**
+     * Files that were added in this action.
+     * Present when action is 'add' or 'replace'.
+     */
+    addedFiles?: FileItem[];
+    /**
+     * Files that were removed in this action.
+     * Present when action is 'remove'.
+     */
+    removedFiles?: FileItem[];
+    /**
+     * The complete list of files after the change.
+     */
+    allFiles: FileItem[];
+    /**
+     * Component-level error if one occurred during the action.
+     */
+    componentError?: {
+        code: COMPONENT_ERROR;
+        message: string;
+    };
+}
+/**
+ * Event emitted after file validation is complete.
+ */
+export interface ValidationEvent {
+    /**
+     * Whether all files passed validation with no component errors.
+     */
+    isValid: boolean;
+    /**
+     * Validation results for each file.
+     */
+    fileResults: Array<{
+        /** ID of the file. Optional for rejected files that are not added to the file list. */
+        id?: string;
+        /** Whether the file has a validation error. */
+        hasError: boolean;
+        /** The error type if validation failed. */
+        error?: FILE_ERROR;
+        /** Human-readable error message. */
+        errorMessage?: string;
+    }>;
+    /**
+     * Component-level errors that occurred during validation.
+     */
+    componentErrors?: Array<{
+        code: COMPONENT_ERROR;
+        message: string;
+    }>;
+}
+/**
+ * Types of announcements that can be made to screen readers.
+ */
+export type AnnouncementType = 'added' | 'removed' | 'cleared' | 'component-error' | 'count-changed';