qucoon-components 0.0.8 → 0.1.0

package/dist/types/components/custom/BaseFileUpload.d.ts

@@ -1,20 +1,60 @@
-export type UploadFileWithProgress = {
-    file: File;
+import { default as React } from 'react';
+/**
+ * Base file representation - works for both new uploads and existing files
+ * Single responsibility: Represent a file in the system
+ */
+export interface FileItem {
+    id: string;
+    name: string;
+    size?: number;
+    type?: string;
+    url?: string;
+    file?: File;
+    metadata?: Record<string, any>;
+}
+/**
+ * Upload state for files being processed
+ * Single responsibility: Track upload progress and status
+ */
+export interface FileUploadState {
+    fileId: string;
+    status: 'pending' | 'uploading' | 'completed' | 'failed' | 'cancelled';
     progress: number;
-    status: string;
-    reason?: string;
-    uploadId: string;
-};
-type BaseFileUploadProps = {
-    files: UploadFileWithProgress[];
-    onFilesChange: (updater: UploadFileWithProgress[] | ((prev: UploadFileWithProgress[]) => UploadFileWithProgress[])) => void;
-    label?: string;
     error?: string;
-    isTouched?: boolean;
-    multiple?: boolean;
+    startedAt?: Date;
+    completedAt?: Date;
+}
+/**
+ * Upload handler function type
+ * Interface segregation: Separate concerns of upload logic
+ */
+export type FileUploadHandler = (file: File, fileId: string, onProgress: (progress: number) => void, onStatusChange: (status: FileUploadState['status'], error?: string) => void) => Promise<{
+    url?: string;
+    metadata?: any;
+}>;
+export interface FileUploadProps {
+    files: FileItem[];
+    onChange: (files: FileItem[]) => void;
+    uploadHandler?: FileUploadHandler;
     autoUpload?: boolean;
-    useExternalUpload?: boolean;
-    externalUploadFunction?: (file: File, uploadId: string, onProgress: (id: string, progress: number, status?: string, reason?: string) => void) => Promise<void>;
-};
-declare const BaseFileUpload: ({ files, onFilesChange, label, error, isTouched, multiple, autoUpload, useExternalUpload, externalUploadFunction, }: BaseFileUploadProps) => import("react/jsx-runtime").JSX.Element;
+    multiple?: boolean;
+    maxFiles?: number;
+    maxSize?: number;
+    accept?: string[];
+    showProgress?: boolean;
+    showFileSize?: boolean;
+    allowReorder?: boolean;
+    disabled?: boolean;
+    validate?: (files: FileItem[]) => string | null;
+    error?: string;
+    isTouched?: boolean;
+    label?: string;
+    placeholder?: string;
+    onUploadComplete?: (fileItem: FileItem, result: any) => void;
+    onUploadError?: (fileItem: FileItem, error: string) => void;
+    onFileRemove?: (fileItem: FileItem) => void;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const BaseFileUpload: React.FC<FileUploadProps>;
 export default BaseFileUpload;

package/dist/types/components/custom/FilePreview.d.ts

@@ -1,13 +1,27 @@
-import { CSSProperties } from 'react';
-type FilePreviewProps = {
-    file: File | string;
-    status?: string;
+import { default as React, CSSProperties } from 'react';
+import { FileItem, FileUploadState } from '..';
+export interface FilePreviewProps {
+    file: File | string | FileItem;
+    status?: FileUploadState['status'];
     progress?: number;
-    documentReason?: string;
+    error?: string;
+    showProgress?: boolean;
+    showFileSize?: boolean;
+    showDownload?: boolean;
+    showDelete?: boolean;
     onDelete?: () => void;
     onDownload?: () => void;
+    onRetry?: () => void;
     statusStyle?: CSSProperties;
     containerStyle?: CSSProperties;
-};
-declare const FilePreview: ({ file, status, progress, documentReason, onDelete, onDownload, statusStyle, containerStyle, }: FilePreviewProps) => import("react/jsx-runtime").JSX.Element;
+    className?: string;
+}
+/**
+ * Enhanced FilePreview component with better separation of concerns
+ * - Handles multiple file input types
+ * - Flexible display options
+ * - Clear action handling
+ * - Better accessibility
+ */
+declare const FilePreview: React.FC<FilePreviewProps>;
 export default FilePreview;

package/dist/types/components/icon/FileFormatsIcon.d.ts

@@ -2,5 +2,5 @@ import { SVGProps } from 'react';
 export type FileFormatTypes = "pdf" | "png" | "jpg" | "doc" | "xls";
 declare function FileFormatsIcon({ fileFormatType, ...props }: SVGProps<SVGSVGElement> & {
     fileFormatType: FileFormatTypes;
-}): import("react/jsx-runtime").JSX.Element | undefined;
+}): import("react/jsx-runtime").JSX.Element;
 export default FileFormatsIcon;

package/dist/types/components/ui/modal/v2/BaseModal.d.ts

@@ -1,7 +1,6 @@
 import { default as React, ReactNode } from 'react';
 import { ModalPosition } from '../../../../utilities/types/modalTypes';
 export interface BaseModalProps {
-    ref: React.RefObject<HTMLDivElement>;
     id: string;
     zIndex?: number;
     backdrop?: 'blur' | 'solid' | 'transparent';
@@ -22,5 +21,5 @@ export interface BaseModalProps {
     size?: 'sm' | 'md' | 'lg' | 'xl' | 'auto';
     cssProps?: Record<string, string>;
 }
-export declare function BaseModal({ ref, id, zIndex, backdrop, closeOnBackdropClick, enableBackDrop, position, offset, animation, theme, size, children, onClose, onFocus, containerClassName, containerStyle, backdropClassName, backdropStyle, cssProps, }: BaseModalProps): import("react/jsx-runtime").JSX.Element;
+export declare const BaseModal: React.ForwardRefExoticComponent<BaseModalProps & React.RefAttributes<HTMLDivElement>>;
 export default BaseModal;

package/dist/types/components/ui/select/ModernSelect.d.ts

@@ -1,6 +1,7 @@
 import { default as React, CSSProperties } from 'react';
-import { FormikProps, FormikValues } from 'formik';
+import { FormikValues } from 'formik';
 import { EnhancedLabelProps } from '../label/EnhancedLabel';
+import { Formik } from '../../../utilities';
 export type ModernSelectOption = {
     value: string;
     label: string;
@@ -28,7 +29,7 @@ export type ModernSelectProps<T extends FormikValues = any> = {
         isLoading?: boolean;
     };
     containerStyle?: CSSProperties;
-    formik?: FormikProps<T>;
+    formik?: Formik<T>;
     value?: string;
     addDefaultSelectOption?: boolean;
 } & React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>;

package/dist/types/utilities/fileUploadUtil.d.ts

@@ -0,0 +1,18 @@
+import { FileItem } from '../components';
+export declare class FileUploadUtil {
+    /**
+     * Generate unique file ID
+     * DRY principle: Centralized ID generation
+     */
+    static generateFileId: () => string;
+    /**
+     * Create FileItem from File object
+     * Factory pattern: Consistent file item creation
+     */
+    static createFileItemFromFile: (file: File, id?: string) => FileItem;
+    /**
+     * Create FileItem from URL (for existing files)
+     * Factory pattern: Consistent file item creation
+     */
+    static createFileItemFromUrl: (url: string, name: string, id?: string, metadata?: Record<string, any>) => FileItem;
+}

package/dist/types/utilities/hooks/index.d.ts

@@ -5,6 +5,8 @@ export { default as useBulkUpload } from './useBulkUpload';
 export * from './useBulkUpload';
 export { default as useFetchOnStageChange } from './useFetchOnStageChange';
 export * from './useFetchOnStageChange';
+export { default as useFileUploadState } from './useFileUploadState';
+export * from './useFileUploadState';
 export { default as useFirstRender } from './useFirstRender';
 export * from './useFirstRender';
 export { default as useModal } from './useModal';

package/dist/types/utilities/hooks/useFileUploadState.d.ts

@@ -0,0 +1,13 @@
+import { FileUploadState } from '../../components';
+/**
+ * Custom hook for managing file upload state
+ * Single responsibility: Manage upload state and provide actions
+ */
+export declare function useFileUploadState(): {
+    uploadStates: Map<string, FileUploadState>;
+    updateUploadState: (fileId: string, updates: Partial<FileUploadState>) => void;
+    removeUploadState: (fileId: string) => void;
+    clearAllStates: () => void;
+    getUploadState: (fileId: string) => FileUploadState | undefined;
+};
+export default useFileUploadState;

package/dist/types/utilities/index.d.ts

@@ -3,6 +3,7 @@
  */
 export * from './baseUtil';
 export * from './enhancedTimeUtil';
+export * from './fileUploadUtil';
 export * from './formUtil';
 export * from './modalRegistrationUtil';
 export * from './modalUtil';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qucoon-components",
-  "version": "0.0.8",
+  "version": "0.1.0",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs.js",