@umituz/react-native-image 1.1.0 → 1.1.2

package/src/domain/entities/Image.ts

@@ -1,273 +0,0 @@
-/**
- * Image Domain - Core Entities
- *
- * This file defines core types and interfaces for image manipulation and viewing.
- * Handles image operations using expo-image-manipulator and react-native-image-viewing.
- */
-
-/**
- * Image format types
- */
-export enum ImageFormat {
-  JPEG = 'jpeg',
-  PNG = 'png',
-  WEBP = 'webp',
-}
-
-/**
- * Image save format for expo-image-manipulator
- */
-export type SaveFormat = 'jpeg' | 'png' | 'webp';
-
-/**
- * Image manipulation action types
- */
-export interface ImageManipulateAction {
-  resize?: { width?: number; height?: number };
-  crop?: { originX: number; originY: number; width: number; height: number };
-  rotate?: number; // degrees
-  flip?: { vertical?: boolean; horizontal?: boolean };
-}
-
-/**
- * Image save options
- */
-export interface ImageSaveOptions {
-  format?: SaveFormat;
-  compress?: number; // 0-1
-  base64?: boolean;
-}
-
-/**
- * Image manipulation result
- */
-export interface ImageManipulationResult {
-  uri: string;
-  width: number;
-  height: number;
-  base64?: string;
-}
-
-/**
- * Image metadata
- */
-export interface ImageMetadata {
-  uri: string;
-  width: number;
-  height: number;
-  format?: ImageFormat;
-  size?: number; // bytes
-  orientation?: ImageOrientation;
-}
-
-/**
- * Image orientation
- */
-export enum ImageOrientation {
-  PORTRAIT = 'portrait',
-  LANDSCAPE = 'landscape',
-  SQUARE = 'square',
-}
-
-/**
- * Image viewer item
- */
-export interface ImageViewerItem {
-  uri: string;
-  title?: string;
-  description?: string;
-  width?: number;
-  height?: number;
-}
-
-/**
- * Image gallery options
- */
-export interface ImageGalleryOptions {
-  index?: number; // Starting index
-  backgroundColor?: string;
-  swipeToCloseEnabled?: boolean;
-  doubleTapToZoomEnabled?: boolean;
-  onDismiss?: () => void;
-  onIndexChange?: (index: number) => void;
-}
-
-/**
- * Image operation result
- */
-export interface ImageOperationResult {
-  success: boolean;
-  uri?: string;
-  error?: string;
-  width?: number;
-  height?: number;
-}
-
-/**
- * Image constants
- */
-export const IMAGE_CONSTANTS = {
-  MAX_WIDTH: 2048,
-  MAX_HEIGHT: 2048,
-  DEFAULT_QUALITY: 0.8,
-  THUMBNAIL_SIZE: 200,
-  COMPRESS_QUALITY: {
-    LOW: 0.5,
-    MEDIUM: 0.7,
-    HIGH: 0.9,
-  },
-  FORMAT: {
-    JPEG: 'jpeg' as SaveFormat,
-    PNG: 'png' as SaveFormat,
-    WEBP: 'webp' as SaveFormat,
-  },
-} as const;
-
-/**
- * Image utilities
- */
-export class ImageUtils {
-  /**
-   * Get image orientation from dimensions
-   */
-  static getOrientation(width: number, height: number): ImageOrientation {
-    if (width > height) return ImageOrientation.LANDSCAPE;
-    if (height > width) return ImageOrientation.PORTRAIT;
-    return ImageOrientation.SQUARE;
-  }
-
-  /**
-   * Calculate aspect ratio
-   */
-  static getAspectRatio(width: number, height: number): number {
-    return width / height;
-  }
-
-  /**
-   * Calculate dimensions to fit within max size while preserving aspect ratio
-   */
-  static fitToSize(
-    width: number,
-    height: number,
-    maxWidth: number,
-    maxHeight: number
-  ): { width: number; height: number } {
-    const aspectRatio = ImageUtils.getAspectRatio(width, height);
-
-    let newWidth = width;
-    let newHeight = height;
-
-    if (width > maxWidth) {
-      newWidth = maxWidth;
-      newHeight = newWidth / aspectRatio;
-    }
-
-    if (newHeight > maxHeight) {
-      newHeight = maxHeight;
-      newWidth = newHeight * aspectRatio;
-    }
-
-    return {
-      width: Math.round(newWidth),
-      height: Math.round(newHeight),
-    };
-  }
-
-  /**
-   * Calculate thumbnail dimensions (maintains aspect ratio)
-   */
-  static getThumbnailSize(
-    width: number,
-    height: number,
-    thumbnailSize: number = IMAGE_CONSTANTS.THUMBNAIL_SIZE
-  ): { width: number; height: number } {
-    return ImageUtils.fitToSize(width, height, thumbnailSize, thumbnailSize);
-  }
-
-  /**
-   * Validate image URI
-   */
-  static isValidImageUri(uri: string): boolean {
-    if (!uri) return false;
-
-    // Check if it's a valid URI format
-    return (
-      uri.startsWith('file://') ||
-      uri.startsWith('content://') ||
-      uri.startsWith('http://') ||
-      uri.startsWith('https://') ||
-      uri.startsWith('data:image/')
-    );
-  }
-
-  /**
-   * Get image format from URI
-   */
-  static getFormatFromUri(uri: string): ImageFormat | null {
-    const lowerUri = uri.toLowerCase();
-
-    if (lowerUri.includes('.jpg') || lowerUri.includes('.jpeg')) {
-      return ImageFormat.JPEG;
-    }
-
-    if (lowerUri.includes('.png')) {
-      return ImageFormat.PNG;
-    }
-
-    if (lowerUri.includes('.webp')) {
-      return ImageFormat.WEBP;
-    }
-
-    return null;
-  }
-
-  /**
-   * Get file extension from format
-   */
-  static getExtensionFromFormat(format: ImageFormat): string {
-    switch (format) {
-      case ImageFormat.JPEG:
-        return 'jpg';
-      case ImageFormat.PNG:
-        return 'png';
-      case ImageFormat.WEBP:
-        return 'webp';
-      default:
-        return 'jpg';
-    }
-  }
-
-  /**
-   * Calculate crop dimensions for square crop (centered)
-   */
-  static getSquareCrop(width: number, height: number): ImageManipulateAction['crop'] {
-    const size = Math.min(width, height);
-    const originX = (width - size) / 2;
-    const originY = (height - size) / 2;
-
-    return {
-      originX: Math.round(originX),
-      originY: Math.round(originY),
-      width: Math.round(size),
-      height: Math.round(size),
-    };
-  }
-
-  /**
-   * Format file size to human-readable string
-   */
-  static formatFileSize(bytes: number): string {
-    if (bytes < 1024) return `${bytes} B`;
-    if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
-    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-  }
-
-  /**
-   * Check if image needs compression based on size
-   */
-  static needsCompression(bytes: number, maxSizeMB: number = 2): boolean {
-    const maxBytes = maxSizeMB * 1024 * 1024;
-    return bytes > maxBytes;
-  }
-}
-

package/src/infrastructure/services/ImageService.ts

@@ -1,316 +0,0 @@
-/**
- * Image Domain - Image Service
- *
- * Service for image manipulation using expo-image-manipulator.
- * Provides abstraction layer for resizing, cropping, rotating images.
- *
- * NOTE: File operations use @umituz/react-native-filesystem (centralized)
- */
-
-import * as ImageManipulator from 'expo-image-manipulator';
-import { FileSystemService } from '@umituz/react-native-filesystem';
-import type {
-  ImageManipulateAction,
-  ImageSaveOptions,
-  ImageManipulationResult,
-  SaveFormat,
-} from '../../domain/entities/Image';
-import { IMAGE_CONSTANTS, ImageUtils } from '../../domain/entities/Image';
-
-/**
- * Image manipulation service
- */
-export class ImageService {
-  /**
-   * Resize image to specified dimensions
-   */
-  static async resize(
-    uri: string,
-    width?: number,
-    height?: number,
-    options?: ImageSaveOptions
-  ): Promise<ImageManipulationResult | null> {
-    try {
-      const result = await ImageManipulator.manipulateAsync(
-        uri,
-        [{ resize: { width, height } }],
-        {
-          compress: options?.compress || IMAGE_CONSTANTS.DEFAULT_QUALITY,
-          format: ImageService.mapFormatToManipulator(options?.format),
-          base64: options?.base64,
-        }
-      );
-
-      return result;
-    } catch (error) {
-      return null;
-    }
-  }
-
-  /**
-   * Crop image to specified area
-   */
-  static async crop(
-    uri: string,
-    cropArea: { originX: number; originY: number; width: number; height: number },
-    options?: ImageSaveOptions
-  ): Promise<ImageManipulationResult | null> {
-    try {
-      const result = await ImageManipulator.manipulateAsync(
-        uri,
-        [{ crop: cropArea }],
-        {
-          compress: options?.compress || IMAGE_CONSTANTS.DEFAULT_QUALITY,
-          format: ImageService.mapFormatToManipulator(options?.format),
-          base64: options?.base64,
-        }
-      );
-
-      return result;
-    } catch (error) {
-      return null;
-    }
-  }
-
-  /**
-   * Rotate image by degrees
-   */
-  static async rotate(
-    uri: string,
-    degrees: number,
-    options?: ImageSaveOptions
-  ): Promise<ImageManipulationResult | null> {
-    try {
-      const result = await ImageManipulator.manipulateAsync(
-        uri,
-        [{ rotate: degrees }],
-        {
-          compress: options?.compress || IMAGE_CONSTANTS.DEFAULT_QUALITY,
-          format: ImageService.mapFormatToManipulator(options?.format),
-          base64: options?.base64,
-        }
-      );
-
-      return result;
-    } catch (error) {
-      return null;
-    }
-  }
-
-  /**
-   * Flip image horizontally or vertically
-   */
-  static async flip(
-    uri: string,
-    flip: { horizontal?: boolean; vertical?: boolean },
-    options?: ImageSaveOptions
-  ): Promise<ImageManipulationResult | null> {
-    try {
-      const actions: ImageManipulator.Action[] = [];
-
-      if (flip.horizontal) {
-        actions.push({ flip: ImageManipulator.FlipType.Horizontal });
-      }
-
-      if (flip.vertical) {
-        actions.push({ flip: ImageManipulator.FlipType.Vertical });
-      }
-
-      const result = await ImageManipulator.manipulateAsync(
-        uri,
-        actions,
-        {
-          compress: options?.compress || IMAGE_CONSTANTS.DEFAULT_QUALITY,
-          format: ImageService.mapFormatToManipulator(options?.format),
-          base64: options?.base64,
-        }
-      );
-
-      return result;
-    } catch (error) {
-      return null;
-    }
-  }
-
-  /**
-   * Perform multiple image manipulations
-   */
-  static async manipulate(
-    uri: string,
-    action: ImageManipulateAction,
-    options?: ImageSaveOptions
-  ): Promise<ImageManipulationResult | null> {
-    try {
-      const manipulatorActions: ImageManipulator.Action[] = [];
-
-      if (action.resize) {
-        manipulatorActions.push({ resize: action.resize });
-      }
-
-      if (action.crop) {
-        manipulatorActions.push({ crop: action.crop });
-      }
-
-      if (action.rotate) {
-        manipulatorActions.push({ rotate: action.rotate });
-      }
-
-      if (action.flip) {
-        if (action.flip.horizontal) {
-          manipulatorActions.push({ flip: ImageManipulator.FlipType.Horizontal });
-        }
-        if (action.flip.vertical) {
-          manipulatorActions.push({ flip: ImageManipulator.FlipType.Vertical });
-        }
-      }
-
-      const result = await ImageManipulator.manipulateAsync(
-        uri,
-        manipulatorActions,
-        {
-          compress: options?.compress || IMAGE_CONSTANTS.DEFAULT_QUALITY,
-          format: ImageService.mapFormatToManipulator(options?.format),
-          base64: options?.base64,
-        }
-      );
-
-      return result;
-    } catch (error) {
-      return null;
-    }
-  }
-
-  /**
-   * Compress image to reduce file size
-   */
-  static async compress(
-    uri: string,
-    quality: number = IMAGE_CONSTANTS.DEFAULT_QUALITY
-  ): Promise<ImageManipulationResult | null> {
-    try {
-      const result = await ImageManipulator.manipulateAsync(
-        uri,
-        [],
-        {
-          compress: quality,
-        }
-      );
-
-      return result;
-    } catch (error) {
-      return null;
-    }
-  }
-
-  /**
-   * Resize image to fit within max dimensions (maintaining aspect ratio)
-   */
-  static async resizeToFit(
-    uri: string,
-    maxWidth: number,
-    maxHeight: number,
-    options?: ImageSaveOptions
-  ): Promise<ImageManipulationResult | null> {
-    try {
-      // Use ImageUtils to calculate fitted dimensions
-      const dimensions = ImageUtils.fitToSize(maxWidth, maxHeight, maxWidth, maxHeight);
-
-      return ImageService.resize(uri, dimensions.width, dimensions.height, options);
-    } catch (error) {
-      return null;
-    }
-  }
-
-  /**
-   * Create thumbnail (small preview image)
-   */
-  static async createThumbnail(
-    uri: string,
-    size: number = IMAGE_CONSTANTS.THUMBNAIL_SIZE,
-    options?: ImageSaveOptions
-  ): Promise<ImageManipulationResult | null> {
-    try {
-      return ImageService.resizeToFit(uri, size, size, {
-        ...options,
-        compress: options?.compress || IMAGE_CONSTANTS.COMPRESS_QUALITY.MEDIUM,
-      });
-    } catch (error) {
-      return null;
-    }
-  }
-
-  /**
-   * Crop image to square (centered)
-   */
-  static async cropToSquare(
-    uri: string,
-    width: number,
-    height: number,
-    options?: ImageSaveOptions
-  ): Promise<ImageManipulationResult | null> {
-    try {
-      const cropArea = ImageUtils.getSquareCrop(width, height);
-      return ImageService.crop(uri, cropArea, options);
-    } catch (error) {
-      return null;
-    }
-  }
-
-  /**
-   * Convert image format
-   */
-  static async convertFormat(
-    uri: string,
-    format: SaveFormat,
-    quality?: number
-  ): Promise<ImageManipulationResult | null> {
-    try {
-      const result = await ImageManipulator.manipulateAsync(
-        uri,
-        [],
-        {
-          compress: quality || IMAGE_CONSTANTS.DEFAULT_QUALITY,
-          format: ImageService.mapFormatToManipulator(format),
-        }
-      );
-
-      return result;
-    } catch (error) {
-      return null;
-    }
-  }
-
-  /**
-   * Save manipulated image to device using FileSystemService
-   */
-  static async saveImage(
-    uri: string,
-    filename?: string
-  ): Promise<string | null> {
-    try {
-      const result = await FileSystemService.copyToDocuments(uri, filename);
-      return result.success ? result.uri : null;
-    } catch (error) {
-      return null;
-    }
-  }
-
-  /**
-   * Map SaveFormat to ImageManipulator.SaveFormat
-   */
-  private static mapFormatToManipulator(
-    format?: SaveFormat
-  ): ImageManipulator.SaveFormat {
-    if (!format || format === 'jpeg') {
-      return ImageManipulator.SaveFormat.JPEG;
-    }
-    if (format === 'png') {
-      return ImageManipulator.SaveFormat.PNG;
-    }
-    if (format === 'webp') {
-      return ImageManipulator.SaveFormat.WEBP;
-    }
-    return ImageManipulator.SaveFormat.JPEG;
-  }
-}
-