jattac.libs.web.zest-file-upload 0.2.0

package/dist/Errors/FileUploadErrorBoundary.d.ts

@@ -0,0 +1,16 @@
+import React, { Component, ErrorInfo, ReactNode } from "react";
+interface FileUploadErrorBoundaryProps {
+    children: ReactNode;
+    fallbackMessage?: string;
+}
+interface FileUploadErrorBoundaryState {
+    hasError: boolean;
+}
+declare class FileUploadErrorBoundary extends Component<FileUploadErrorBoundaryProps, FileUploadErrorBoundaryState> {
+    constructor(props: FileUploadErrorBoundaryProps);
+    static getDerivedStateFromError(): FileUploadErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    handleRetry: () => void;
+    render(): string | number | boolean | Iterable<React.ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
+}
+export default FileUploadErrorBoundary;

package/dist/Hooks/useBrowser.d.ts

@@ -0,0 +1,3 @@
+export declare function useBrowser(): {
+    isBrowser: boolean;
+};

package/dist/Hooks/useCamera.d.ts

@@ -0,0 +1,34 @@
+import type { CameraView, CropArea, FileUploadLabels } from "../Types/types";
+interface UseCameraOptions {
+    capture?: "user" | "environment";
+    onFileSelect: (file: File | null) => Promise<void>;
+    setStatus: (status: "idle" | "uploading" | "complete" | "error") => void;
+    onError?: (error: string) => void;
+    labels: FileUploadLabels;
+}
+export declare function useCamera({ capture, onFileSelect, setStatus, onError, labels, }: UseCameraOptions): {
+    stream: MediaStream | null;
+    cameraView: CameraView;
+    facingMode: "user" | "environment";
+    flashEnabled: boolean;
+    capturedImage: string | null;
+    cameraError: string | null;
+    videoReady: boolean;
+    cameraLoading: boolean;
+    videoRef: import("react").RefObject<HTMLVideoElement>;
+    canvasRef: import("react").RefObject<HTMLCanvasElement>;
+    cameraInputRef: import("react").RefObject<HTMLInputElement>;
+    torchSupported: boolean;
+    cropCompleteArea: CropArea | null;
+    handleCameraClick: (e: React.MouseEvent<HTMLButtonElement>) => Promise<void>;
+    cancelCamera: () => void;
+    toggleCamera: () => Promise<void>;
+    toggleFlash: () => Promise<void>;
+    capturePhoto: () => void;
+    retakePhoto: () => Promise<void>;
+    confirmPhoto: () => void;
+    cancelCrop: () => void;
+    applyCrop: () => Promise<void>;
+    setCropCompleteArea: import("react").Dispatch<import("react").SetStateAction<CropArea | null>>;
+};
+export {};

package/dist/Hooks/useFileValidation.d.ts

@@ -0,0 +1,6 @@
+export declare const useFileValidation: (accept: string, maxSize?: number) => {
+    validate: (file: File) => {
+        isValid: boolean;
+        error: string | null;
+    };
+};

package/dist/Types/types.d.ts

@@ -0,0 +1,82 @@
+export interface CompressionOptions {
+    maxWidth: number;
+    maxHeight: number;
+    quality: number;
+    mimeType: string;
+}
+export type CameraView = "none" | "loading" | "preview" | "captured" | "crop";
+export interface CropArea {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export type FileUploadStatus = "idle" | "uploading" | "complete" | "error";
+export interface FileUploadLabels {
+    browseFiles: string;
+    takePhoto: string;
+    uploadComplete: string;
+    uploadFailed: string;
+    uploading: string;
+    noFileSelected: string;
+    invalidFileType: string;
+    cameraError: string;
+    retake: string;
+    usePhoto: string;
+    cancel: string;
+    switchCamera: string;
+    toggleFlash: string;
+    cropTitle: string;
+    cropSave: string;
+    cropCancel: string;
+}
+export interface FileUploadRef {
+    clearFile: () => void;
+    clearAll: () => void;
+}
+export type FileEntryId = string;
+export type FileEntryStatus = "pending" | "uploading" | "complete" | "error";
+export interface FileEntry {
+    id: FileEntryId;
+    file: File;
+    status: FileEntryStatus;
+    error: string | null;
+}
+export interface MultiFileUploadLabels {
+    addMoreFiles: string;
+    removeFile: string;
+    filesQueued: string;
+    clearAll: string;
+    pending: string;
+    retryFile: string;
+}
+export interface FileUploadIcons {
+    camera: React.ReactNode;
+    browse: React.ReactNode;
+    close: React.ReactNode;
+    flashOn: React.ReactNode;
+    flashOff: React.ReactNode;
+    switchCamera: React.ReactNode;
+    retake: React.ReactNode;
+    confirm: React.ReactNode;
+}
+export interface FileUploadProps {
+    label: string;
+    onFileSelect: (file: File | null) => Promise<void>;
+    progressPercentage?: number;
+    disabled?: boolean;
+    accept?: string;
+    capture?: "user" | "environment";
+    hideCompletionMessage?: boolean;
+    onError?: (error: string) => void;
+    maxFileSize?: number;
+    labels?: Partial<FileUploadLabels>;
+    errorBoundary?: boolean;
+    successTimeout?: number;
+    icons?: Partial<FileUploadIcons>;
+    multiple?: boolean;
+    onFilesSelect?: (files: File[]) => Promise<void>;
+    filesProgress?: Record<FileEntryId, number>;
+    maxFiles?: number;
+    multiLabels?: Partial<MultiFileUploadLabels>;
+}

package/dist/UI/CameraCapture.d.ts

@@ -0,0 +1,33 @@
+import React from "react";
+import type { CameraView, CropArea, FileUploadLabels } from "../Types/types";
+interface CameraCaptureProps {
+    cameraView: CameraView;
+    facingMode: "user" | "environment";
+    flashEnabled: boolean;
+    capturedImage: string | null;
+    cameraError: string | null;
+    cameraLoading: boolean;
+    videoRef: React.RefObject<HTMLVideoElement>;
+    canvasRef: React.RefObject<HTMLCanvasElement>;
+    torchSupported: boolean;
+    labels: FileUploadLabels;
+    icons: {
+        close: React.ReactNode;
+        flashOn: React.ReactNode;
+        flashOff: React.ReactNode;
+        switchCamera: React.ReactNode;
+        retake: React.ReactNode;
+        confirm: React.ReactNode;
+    };
+    onCancel: () => void;
+    onToggleCamera: () => void;
+    onToggleFlash: () => void;
+    onCapture: () => void;
+    onRetake: () => void;
+    onConfirm: () => void;
+    onCropCancel: () => void;
+    onApplyCrop: () => void;
+    onCropComplete: (area: CropArea) => void;
+}
+declare const CameraCapture: React.FC<CameraCaptureProps>;
+export default CameraCapture;

package/dist/UI/FileUpload.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import type { FileUploadProps, FileUploadRef } from "../Types/types";
+declare const FileUpload: React.ForwardRefExoticComponent<FileUploadProps & React.RefAttributes<FileUploadRef>>;
+export default FileUpload;

package/dist/UI/index.d.ts

@@ -0,0 +1,3 @@
+export { default as ZestFileUpload } from "./FileUpload";
+export { default } from "./FileUpload";
+export type { FileUploadProps, FileUploadRef, FileUploadLabels, FileUploadIcons, FileEntryId, FileEntryStatus, FileEntry, MultiFileUploadLabels, } from "../Types/types";