skillgrid 0.0.67 → 0.0.68

package/dist/components/FileUpload/FileUpload.d.ts

@@ -0,0 +1,2 @@
+import { FileUploadProps } from './FileUpload.type';
+export declare const FileUpload: import('react').ForwardRefExoticComponent<FileUploadProps & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/FileUpload/FileUpload.type.d.ts

@@ -0,0 +1,201 @@
+import { ReactNode } from 'react';
+export type FileUploadStatus = 'idle' | 'uploading' | 'success' | 'error';
+export type FileUploadRejectReason = 'accept' | 'maxFileSize';
+export type FileUploadLayout = 'vertical' | 'horizontal' | 'button';
+export type FileUploadSortOrder = 'newest-first' | 'provided';
+export interface FileUploadAction {
+    /**
+     * Unique action identifier
+     */
+    id: string;
+    /**
+     * Action label
+     */
+    label: string;
+    /**
+     * Optional action icon
+     */
+    icon?: ReactNode;
+    /**
+     * Visual tone for action item
+     * @default 'default'
+     */
+    tone?: 'default' | 'danger';
+    /**
+     * Disabled state for action item
+     * @default false
+     */
+    disabled?: boolean;
+}
+export interface FileUploadItem {
+    /**
+     * Unique file item identifier
+     */
+    id: string;
+    /**
+     * File name
+     */
+    name: string;
+    /**
+     * File size in bytes
+     */
+    size: number;
+    /**
+     * MIME type
+     */
+    mimeType?: string;
+    /**
+     * Upload or creation timestamp used for newest-first sorting
+     */
+    createdAt?: string | number | Date;
+    /**
+     * Preview URL for images
+     */
+    previewUrl?: string;
+    /**
+     * Visual upload state
+     * @default 'idle'
+     */
+    status?: FileUploadStatus;
+    /**
+     * Upload progress from 0 to 100
+     */
+    progress?: number;
+    /**
+     * Error text for failed uploads
+     */
+    error?: string;
+    /**
+     * Download URL
+     */
+    downloadUrl?: string;
+    /**
+     * Disabled state for this file row
+     * @default false
+     */
+    disabled?: boolean;
+}
+export interface FileUploadRejectedFile {
+    /**
+     * Original rejected file
+     */
+    file: File;
+    /**
+     * Rejection reason
+     */
+    reason: FileUploadRejectReason;
+}
+export interface FileUploadSelectionContext {
+    /**
+     * Existing items that should be removed when maxFiles limit is exceeded
+     */
+    overflowedItems: FileUploadItem[];
+    /**
+     * Files from the current selection batch that were trimmed by maxFiles
+     */
+    overflowedFiles: File[];
+    /**
+     * Applied max files limit
+     */
+    maxFiles?: number;
+}
+export interface FileUploadProps {
+    /**
+     * Controlled list of files
+     */
+    items: FileUploadItem[];
+    /**
+     * Callback with accepted files from a single selection/drop batch
+     */
+    onSelectFiles?: (files: File[], context: FileUploadSelectionContext) => void;
+    /**
+     * Callback with rejected files from a single selection/drop batch
+     */
+    onReject?: (rejections: FileUploadRejectedFile[]) => void;
+    /**
+     * Remove callback for built-in remove action
+     */
+    onRemoveFile?: (item: FileUploadItem) => void;
+    /**
+     * Callback for custom action items
+     */
+    onAction?: (actionId: string, item: FileUploadItem) => void;
+    /**
+     * Retry callback for failed uploads
+     */
+    onRetryFile?: (item: FileUploadItem) => void;
+    /**
+     * Custom row actions or factory by item
+     */
+    actions?: FileUploadAction[] | ((item: FileUploadItem) => FileUploadAction[]);
+    /**
+     * Additional actions for media preview card
+     */
+    previewActions?: FileUploadAction[] | ((item: FileUploadItem) => FileUploadAction[]);
+    /**
+     * Accept attribute string
+     * @default '.jpg,.jpeg,.png,.doc,.pdf,image/jpeg,image/png,application/msword,application/pdf'
+     */
+    accept?: string;
+    /**
+     * Allow selecting multiple files
+     * @default false
+     */
+    multiple?: boolean;
+    /**
+     * Max file size in bytes
+     * @default 10485760
+     */
+    maxFileSize?: number;
+    /**
+     * Max amount of files preserved in the list.
+     * New selections keep the newest files and report overflow via onSelectFiles context.
+     */
+    maxFiles?: number;
+    /**
+     * Disabled state
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Component layout variant
+     * @default 'vertical'
+     */
+    layout?: FileUploadLayout;
+    /**
+     * Shows preview card for a single uploaded media file in vertical layout
+     * @default false
+     */
+    showMediaPreview?: boolean;
+    /**
+     * Order used for rendering controlled items
+     * @default 'newest-first'
+     */
+    sortOrder?: FileUploadSortOrder;
+    /**
+     * Shows a built-in error snackbar for rejected files when SnackbarProvider is mounted
+     * @default true
+     */
+    showRejectSnackbar?: boolean;
+    /**
+     * Dropzone title
+     */
+    title?: ReactNode;
+    /**
+     * Dropzone description
+     */
+    description?: ReactNode;
+    /**
+     * Trigger button label
+     */
+    buttonLabel?: ReactNode;
+    /**
+     * Additional root class name
+     */
+    className?: string;
+    /**
+     * Test id for the root element
+     * @default 'file-upload'
+     */
+    'data-testid'?: string;
+}

package/dist/components/FileUpload/index.d.ts

@@ -0,0 +1,2 @@
+export { FileUpload } from './FileUpload';
+export type { FileUploadAction, FileUploadItem, FileUploadLayout, FileUploadProps, FileUploadRejectedFile, FileUploadRejectReason, FileUploadSelectionContext, FileUploadSortOrder, FileUploadStatus, } from './FileUpload.type';