@umituz/react-native-design-system 4.25.11 → 4.25.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-design-system",
-  "version": "4.25.11",
+  "version": "4.25.13",
   "description": "Universal design system for React Native apps - Consolidated package with atoms, molecules, organisms, theme, typography, responsive, safe area, exception, infinite scroll, UUID, image, timezone, offline, onboarding, and loading utilities",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/gallery/gallery-download.service.ts

@@ -0,0 +1,69 @@
+/**
+ * Gallery Download Service
+ * Single Responsibility: Download remote media to local storage
+ */
+
+import { FileSystemService } from "../filesystem";
+import { validateImageUri, getFileExtension } from "../image";
+import { timezoneService } from "../timezone";
+import type { DownloadMediaResult } from "./types";
+
+const generateFilename = (uri: string, prefix: string): string => {
+  const extension = getFileExtension(uri) || "jpg";
+  const timestamp = timezoneService.formatDateToString(new Date());
+  const randomId = Math.random().toString(36).substring(2, 10);
+  return `${prefix}_${timestamp}_${randomId}.${extension}`;
+};
+
+class GalleryDownloadService {
+  async downloadMedia(
+    mediaUri: string,
+    prefix: string = "media",
+  ): Promise<DownloadMediaResult> {
+    try {
+      const validationResult = validateImageUri(mediaUri, "Media");
+      if (!validationResult.isValid) {
+        return {
+          success: false,
+          error: validationResult.error || "Invalid media file",
+        };
+      }
+
+      const filename = generateFilename(mediaUri, prefix);
+      const documentDir = FileSystemService.getDocumentDirectory();
+      const fileUri = `${documentDir}${filename}`;
+
+      const downloadResult = await FileSystemService.downloadFile(
+        mediaUri,
+        fileUri,
+      );
+
+      if (!downloadResult.success || !downloadResult.uri) {
+        return {
+          success: false,
+          error: downloadResult.error || "Download failed",
+        };
+      }
+
+      return {
+        success: true,
+        localUri: downloadResult.uri,
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Download failed",
+      };
+    }
+  }
+
+  isRemoteUrl(uri: string): boolean {
+    return uri.startsWith("http://") || uri.startsWith("https://");
+  }
+
+  async cleanupFile(fileUri: string): Promise<void> {
+    await FileSystemService.deleteFile(fileUri);
+  }
+}
+
+export const galleryDownloadService = new GalleryDownloadService();

package/src/gallery/gallery-save.service.ts

@@ -0,0 +1,80 @@
+/**
+ * Gallery Save Service
+ * Single Responsibility: Save media to device gallery
+ */
+
+import * as MediaLibrary from "expo-media-library";
+import { validateImageUri } from "../image";
+import { galleryDownloadService } from "./gallery-download.service";
+import type { SaveMediaResult } from "./types";
+
+const requestMediaPermissions = async (): Promise<boolean> => {
+  try {
+    const { status } = await MediaLibrary.requestPermissionsAsync();
+    return status === "granted";
+  } catch {
+    return false;
+  }
+};
+
+class GallerySaveService {
+  async saveToGallery(
+    mediaUri: string,
+    prefix?: string,
+  ): Promise<SaveMediaResult> {
+    try {
+      const validationResult = validateImageUri(mediaUri, "Media");
+      if (!validationResult.isValid) {
+        return {
+          success: false,
+          error: validationResult.error || "Invalid media file",
+        };
+      }
+
+      const hasPermission = await requestMediaPermissions();
+      if (!hasPermission) {
+        return {
+          success: false,
+          error: "Media library permission denied",
+        };
+      }
+
+      let localUri = mediaUri;
+      const isRemote = galleryDownloadService.isRemoteUrl(mediaUri);
+
+      if (isRemote) {
+        const downloadResult = await galleryDownloadService.downloadMedia(
+          mediaUri,
+          prefix,
+        );
+
+        if (!downloadResult.success || !downloadResult.localUri) {
+          return {
+            success: false,
+            error: downloadResult.error || "Download failed",
+          };
+        }
+
+        localUri = downloadResult.localUri;
+      }
+
+      const asset = await MediaLibrary.createAssetAsync(localUri);
+
+      if (isRemote && localUri) {
+        await galleryDownloadService.cleanupFile(localUri);
+      }
+
+      return {
+        success: true,
+        fileUri: asset.uri,
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Save failed",
+      };
+    }
+  }
+}
+
+export const gallerySaveService = new GallerySaveService();

package/src/gallery/index.ts

@@ -0,0 +1,3 @@
+export { gallerySaveService } from "./gallery-save.service";
+export { galleryDownloadService } from "./gallery-download.service";
+export type { SaveMediaResult, DownloadMediaResult } from "./types";

package/src/gallery/types.ts

@@ -0,0 +1,11 @@
+export interface SaveMediaResult {
+  success: boolean;
+  fileUri?: string;
+  error?: string;
+}
+
+export interface DownloadMediaResult {
+  success: boolean;
+  localUri?: string;
+  error?: string;
+}

package/src/index.ts

@@ -2,16 +2,8 @@
  * @umituz/react-native-design-system
  * Universal design system for React Native apps
  *
- * This main entry point exports only modules with NO optional native dependencies.
- * Modules with native dependencies are available via sub-path imports:
- *   - @umituz/react-native-design-system/gallery    (expo-media-library)
- *   - @umituz/react-native-design-system/media       (expo-file-system, expo-image-picker, expo-media-library)
- *   - @umituz/react-native-design-system/filesystem   (expo-file-system)
- *   - @umituz/react-native-design-system/image        (expo-file-system, expo-image-manipulator)
- *   - @umituz/react-native-design-system/device       (expo-device, expo-secure-store)
- *   - @umituz/react-native-design-system/offline      (expo-network)
- *   - @umituz/react-native-design-system/onboarding   (expo-video)
- *   - @umituz/react-native-design-system/storage      (expo-secure-store)
+ * Consolidated package including all modules.
+ * Sub-path imports also available (e.g. @umituz/react-native-design-system/media)
  */
 
 // =============================================================================
@@ -29,6 +21,11 @@ export * from "./typography";
 // =============================================================================
 export * from "./responsive";
 
+// =============================================================================
+// DEVICE EXPORTS
+// =============================================================================
+export * from "./device";
+
 // =============================================================================
 // ATOMS EXPORTS
 // =============================================================================
@@ -64,27 +61,67 @@ export * from "./exception";
 // =============================================================================
 export * from "./infinite-scroll";
 
+// =============================================================================
+// UUID EXPORTS
+// =============================================================================
+export * from "./uuid";
+
 // =============================================================================
 // TIMEZONE EXPORTS
 // =============================================================================
 export * from "./timezone";
 
+// =============================================================================
+// OFFLINE EXPORTS
+// =============================================================================
+export * from "./offline";
+
+// =============================================================================
+// IMAGE EXPORTS
+// =============================================================================
+export * from "./image";
+
 // =============================================================================
 // HAPTICS EXPORTS
 // =============================================================================
 export * from "./haptics";
 
+// =============================================================================
+// MEDIA EXPORTS
+// =============================================================================
+export * from "./media";
+
 // =============================================================================
 // VARIANT UTILITIES
 // =============================================================================
 export * from "./presentation/utils/variants";
 
+// =============================================================================
+// UTILITIES
+// =============================================================================
+export * from "./utilities";
+
 // =============================================================================
 // UTILS EXPORTS (Logger, formatters, validators)
 // =============================================================================
 export { logger, Logger } from "./utils/logger";
 export type { LoggerConfig } from "./utils/logger";
 
+// =============================================================================
+// STORAGE EXPORTS
+// =============================================================================
+export * from "./storage";
+
+// =============================================================================
+// ONBOARDING EXPORTS
+// =============================================================================
+export * from "./onboarding";
+
+// =============================================================================
+// FILESYSTEM EXPORTS
+// =============================================================================
+export * from "./filesystem";
+
 // =============================================================================
 // TANSTACK EXPORTS
 // =============================================================================
@@ -101,21 +138,11 @@ export * from "./loading";
 export * from "./init";
 
 // =============================================================================
-// STORAGE EXPORTS
+// GALLERY EXPORTS
 // =============================================================================
-export * from "./storage";
+export * from "./gallery";
 
 // =============================================================================
 // CAROUSEL EXPORTS
 // =============================================================================
 export * from "./carousel";
-
-// =============================================================================
-// OFFLINE EXPORTS
-// =============================================================================
-export * from "./offline";
-
-// =============================================================================
-// ONBOARDING EXPORTS
-// =============================================================================
-export * from "./onboarding";

package/src/offline/presentation/hooks/useOffline.ts

@@ -1,17 +1,33 @@
 /**
  * useOffline Hook
  * Primary hook for accessing offline state in components
- * Automatically subscribes to network changes via expo-network
+ * Automatically subscribes to network changes via expo-network (lazy loaded)
  */
 
 import { useEffect, useCallback, useRef, useMemo } from 'react';
-import * as Network from 'expo-network';
 import type { NetworkState as ExpoNetworkState } from 'expo-network';
 import type { NetworkState, OfflineConfig } from '../../types';
 import { useOfflineStore } from '../../infrastructure/storage/OfflineStore';
 import { networkEvents } from '../../infrastructure/events/NetworkEvents';
 import { useOfflineConfigStore } from '../../infrastructure/storage/OfflineConfigStore';
 
+/**
+ * Lazy-load expo-network to avoid crash when native module is not available
+ * (e.g. running in Expo Go without a custom dev build)
+ */
+let _networkModule: typeof import('expo-network') | null = null;
+
+const getNetworkModule = (): typeof import('expo-network') | null => {
+  if (_networkModule !== null) return _networkModule;
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    _networkModule = require('expo-network') as typeof import('expo-network');
+    return _networkModule;
+  } catch {
+    return null;
+  }
+};
+
 /**
  * Convert expo-network state to our internal format
  */
@@ -67,6 +83,15 @@ export const useOffline = (config?: OfflineConfig) => {
 
     isMountedRef.current = true;
 
+    const Network = getNetworkModule();
+
+    if (!Network) {
+      if (__DEV__ || mergedConfig.debug) {
+        console.warn('[DesignSystem] useOffline: expo-network native module not available. Network state tracking disabled.');
+      }
+      return;
+    }
+
     Network.getNetworkStateAsync()
       .then((state: ExpoNetworkState) => {
         if (isMountedRef.current) {

package/src/utilities/clipboard/ClipboardUtils.ts

@@ -0,0 +1,67 @@
+/**
+ * Clipboard Utilities
+ * 
+ * Simple wrapper around expo-clipboard for copy/paste functionality
+ * 
+ * Usage:
+ * ```typescript
+ * import { ClipboardUtils } from '@umituz/react-native-design-system';
+ * 
+ * // Copy text
+ * await ClipboardUtils.copyToClipboard('Hello World');
+ * 
+ * // Paste text
+ * const text = await ClipboardUtils.getFromClipboard();
+ * 
+ * // Check if clipboard has content
+ * const hasContent = await ClipboardUtils.hasContent();
+ * ```
+ */
+
+import * as Clipboard from 'expo-clipboard';
+
+export class ClipboardUtils {
+    /**
+     * Copy text to clipboard
+     */
+    static async copyToClipboard(text: string): Promise<void> {
+        try {
+            await Clipboard.setStringAsync(text);
+        } catch (error) {
+            throw error;
+        }
+    }
+
+    /**
+     * Get text from clipboard
+     */
+    static async getFromClipboard(): Promise<string> {
+        try {
+            return await Clipboard.getStringAsync();
+        } catch (error) {
+            throw error;
+        }
+    }
+
+    /**
+     * Check if clipboard has content
+     */
+    static async hasContent(): Promise<boolean> {
+        try {
+            return await Clipboard.hasStringAsync();
+        } catch {
+            return false;
+        }
+    }
+
+    /**
+     * Clear clipboard
+     */
+    static async clear(): Promise<void> {
+        try {
+            await Clipboard.setStringAsync('');
+        } catch (error) {
+            throw error;
+        }
+    }
+}

package/src/utilities/clipboard/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Clipboard - Public API
+ */
+
+export { ClipboardUtils } from './ClipboardUtils';

package/src/utilities/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Utilities - Public API
+ */
+
+export * from './clipboard';
+export * from './sharing';

package/src/utilities/sharing/domain/entities/Share.ts

@@ -0,0 +1,104 @@
+/**
+ * Sharing Domain - Core Entities
+ *
+ * This file defines core types and interfaces for sharing functionality.
+ * Handles system share sheet using expo-sharing.
+ *
+ * @domain sharing
+ * @layer domain/entities
+ */
+
+/**
+ * Share options for sharing content
+ */
+export interface ShareOptions {
+  /**
+   * Dialog title (Android only)
+   */
+  dialogTitle?: string;
+
+  /**
+   * MIME type of the file being shared
+   */
+  mimeType?: string;
+
+  /**
+   * UTI (Uniform Type Identifier) for the file (iOS only)
+   */
+  UTI?: string;
+}
+
+/**
+ * Share result
+ */
+export interface ShareResult {
+  success: boolean;
+  error?: string;
+}
+
+/**
+ * Common MIME types for sharing
+ */
+export const MIME_TYPES = {
+  // Images
+  IMAGE_JPEG: 'image/jpeg',
+  IMAGE_PNG: 'image/png',
+  IMAGE_GIF: 'image/gif',
+  IMAGE_WEBP: 'image/webp',
+
+  // Videos
+  VIDEO_MP4: 'video/mp4',
+  VIDEO_QUICKTIME: 'video/quicktime',
+  VIDEO_AVI: 'video/avi',
+
+  // Audio
+  AUDIO_MP3: 'audio/mpeg',
+  AUDIO_WAV: 'audio/wav',
+  AUDIO_AAC: 'audio/aac',
+
+  // Documents
+  PDF: 'application/pdf',
+  TEXT: 'text/plain',
+  JSON: 'application/json',
+  ZIP: 'application/zip',
+
+  // Generic
+  OCTET_STREAM: 'application/octet-stream',
+} as const;
+
+/**
+ * iOS UTI (Uniform Type Identifiers)
+ */
+export const UTI_TYPES = {
+  // Images
+  IMAGE: 'public.image',
+  JPEG: 'public.jpeg',
+  PNG: 'public.png',
+
+  // Videos
+  VIDEO: 'public.video',
+  MOVIE: 'public.movie',
+
+  // Audio
+  AUDIO: 'public.audio',
+  MP3: 'public.mp3',
+
+  // Documents
+  PDF: 'com.adobe.pdf',
+  TEXT: 'public.text',
+  JSON: 'public.json',
+
+  // Generic
+  DATA: 'public.data',
+  CONTENT: 'public.content',
+} as const;
+
+/**
+ * Sharing constants
+ */
+export const SHARING_CONSTANTS = {
+  DEFAULT_DIALOG_TITLE: 'Share',
+  DEFAULT_MIME_TYPE: MIME_TYPES.OCTET_STREAM,
+} as const;
+
+

package/src/utilities/sharing/domain/entities/SharingUtils.ts

@@ -0,0 +1,111 @@
+/**
+ * Sharing Utilities
+ * Helper functions for sharing functionality
+ */
+
+import { MIME_TYPES, UTI_TYPES, SHARING_CONSTANTS, ShareOptions } from './Share';
+
+export class SharingUtils {
+  /**
+   * Get MIME type from file extension
+   */
+  static getMimeTypeFromExtension(filename: string): string {
+    const extension = filename.split('.').pop()?.toLowerCase();
+
+    switch (extension) {
+      // Images
+      case 'jpg':
+      case 'jpeg':
+        return MIME_TYPES.IMAGE_JPEG;
+      case 'png':
+        return MIME_TYPES.IMAGE_PNG;
+      case 'gif':
+        return MIME_TYPES.IMAGE_GIF;
+      case 'webp':
+        return MIME_TYPES.IMAGE_WEBP;
+
+      // Videos
+      case 'mp4':
+        return MIME_TYPES.VIDEO_MP4;
+      case 'mov':
+        return MIME_TYPES.VIDEO_QUICKTIME;
+      case 'avi':
+        return MIME_TYPES.VIDEO_AVI;
+
+      // Audio
+      case 'mp3':
+        return MIME_TYPES.AUDIO_MP3;
+      case 'wav':
+        return MIME_TYPES.AUDIO_WAV;
+      case 'aac':
+        return MIME_TYPES.AUDIO_AAC;
+
+      // Documents
+      case 'pdf':
+        return MIME_TYPES.PDF;
+      case 'txt':
+        return MIME_TYPES.TEXT;
+      case 'json':
+        return MIME_TYPES.JSON;
+      case 'zip':
+        return MIME_TYPES.ZIP;
+
+      default:
+        return MIME_TYPES.OCTET_STREAM;
+    }
+  }
+
+  /**
+   * Get UTI from file extension (iOS)
+   */
+  static getUTIFromExtension(filename: string): string {
+    const extension = filename.split('.').pop()?.toLowerCase();
+
+    switch (extension) {
+      // Images
+      case 'jpg':
+      case 'jpeg':
+        return UTI_TYPES.JPEG;
+      case 'png':
+        return UTI_TYPES.PNG;
+      case 'gif':
+      case 'webp':
+        return UTI_TYPES.IMAGE;
+
+      // Videos
+      case 'mp4':
+      case 'mov':
+      case 'avi':
+        return UTI_TYPES.VIDEO;
+
+      // Audio
+      case 'mp3':
+        return UTI_TYPES.MP3;
+      case 'wav':
+      case 'aac':
+        return UTI_TYPES.AUDIO;
+
+      // Documents
+      case 'pdf':
+        return UTI_TYPES.PDF;
+      case 'txt':
+        return UTI_TYPES.TEXT;
+      case 'json':
+        return UTI_TYPES.JSON;
+
+      default:
+        return UTI_TYPES.DATA;
+    }
+  }
+
+  /**
+   * Prepare share options from filename
+   */
+  static prepareShareOptions(filename: string, dialogTitle?: string): ShareOptions {
+    return {
+      dialogTitle: dialogTitle || SHARING_CONSTANTS.DEFAULT_DIALOG_TITLE,
+      mimeType: SharingUtils.getMimeTypeFromExtension(filename),
+      UTI: SharingUtils.getUTIFromExtension(filename),
+    };
+  }
+}

package/src/utilities/sharing/index.ts

@@ -0,0 +1,33 @@
+/**
+ * Sharing Domain - Barrel Export
+ * Provides system share sheet functionality using expo-sharing.
+ */
+
+// ============================================================================
+// DOMAIN LAYER - ENTITIES
+// ============================================================================
+
+export type {
+  ShareOptions,
+  ShareResult,
+} from './domain/entities/Share';
+
+export {
+  MIME_TYPES,
+  UTI_TYPES,
+  SHARING_CONSTANTS,
+} from './domain/entities/Share';
+
+export { SharingUtils } from './domain/entities/SharingUtils';
+
+// ============================================================================
+// INFRASTRUCTURE LAYER - SERVICES
+// ============================================================================
+
+export { SharingService } from './infrastructure/services/SharingService';
+
+// ============================================================================
+// PRESENTATION LAYER - HOOKS
+// ============================================================================
+
+export { useSharing } from './presentation/hooks/useSharing';

package/src/utilities/sharing/infrastructure/services/SharingService.ts

@@ -0,0 +1,165 @@
+/**
+ * Sharing Domain - Sharing Service
+ *
+ * Service for sharing files using expo-sharing.
+ * Provides abstraction layer for system share sheet.
+ *
+ * @domain sharing
+ * @layer infrastructure/services
+ */
+
+import * as Sharing from 'expo-sharing';
+import { FileSystemService } from '../../../../filesystem';
+import type { ShareOptions, ShareResult } from '../../domain/entities/Share';
+import { SharingUtils } from '../../domain/entities/SharingUtils';
+
+/**
+ * Sharing service for sharing files via system share sheet
+ */
+export class SharingService {
+  /**
+   * Check if sharing is available on device
+   */
+  static async isAvailable(): Promise<boolean> {
+    try {
+      return await Sharing.isAvailableAsync();
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Share a file via system share sheet
+   *
+   * @param uri - File URI to share (can be local or remote http/https)
+   * @param options - Share options (dialog title, MIME type, UTI)
+   * @returns ShareResult with success status
+   *
+   * USAGE:
+   * ```typescript
+   * // Basic share (local)
+   * await SharingService.shareFile('file:///path/to/image.jpg');
+   *
+   * // Remote file (will be downloaded)
+   * await SharingService.shareFile('https://example.com/image.jpg');
+   * ```
+   */
+  static async shareFile(uri: string, options?: ShareOptions): Promise<ShareResult> {
+    try {
+      // Check availability
+      const available = await SharingService.isAvailable();
+      if (!available) {
+        return {
+          success: false,
+          error: 'Sharing is not available on this device',
+        };
+      }
+
+      let shareUri = uri;
+
+      // Handle remote URLs
+      if (uri.startsWith('http://') || uri.startsWith('https://')) {
+        try {
+          const filename = uri.split('/').pop()?.split('?')[0] || `share-${Date.now()}`;
+          // Ensure we have an extension if possible, or default to bin/jpg? 
+          // Better to rely on what we have, or let the caller specify mimeType to infer extension?
+          // For now, nice and simple:
+          const localUri = FileSystemService.generateFilePath(filename);
+          const result = await FileSystemService.downloadFile(uri, localUri);
+
+          if (!result.success) {
+            return { success: false, error: result.error || 'Failed to download file' };
+          }
+          shareUri = result.uri!;
+        } catch (downloadError) {
+          return {
+            success: false,
+            error: downloadError instanceof Error ? downloadError.message : 'Failed to download file'
+          };
+        }
+      }
+
+      // Share file
+      await Sharing.shareAsync(shareUri, options);
+
+      return { success: true };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : 'Failed to share file',
+      };
+    }
+  }
+
+  /**
+   * Share a file with automatic MIME type detection
+   *
+   * @param uri - File URI to share
+   * @param filename - Filename (used for MIME type detection)
+   * @param dialogTitle - Optional dialog title (Android)
+   * @returns ShareResult with success status
+   *
+   * USAGE:
+   * ```typescript
+   * // Auto-detect MIME type from filename
+   * await SharingService.shareWithAutoType(
+   *   'file:///path/to/file.jpg',
+   *   'photo.jpg',
+   *   'Share Photo'
+   * );
+   * ```
+   */
+  static async shareWithAutoType(
+    uri: string,
+    filename: string,
+    dialogTitle?: string
+  ): Promise<ShareResult> {
+    const options = SharingUtils.prepareShareOptions(filename, dialogTitle);
+    return await SharingService.shareFile(uri, options);
+  }
+
+  /**
+   * Share multiple files (if supported)
+   *
+   * NOTE: expo-sharing currently only supports sharing one file at a time.
+   * This method shares files sequentially.
+   *
+   * @param uris - Array of file URIs to share
+   * @param options - Share options
+   * @returns ShareResult with success status
+   */
+  static async shareMultipleFiles(
+    uris: string[],
+    options?: ShareOptions
+  ): Promise<ShareResult> {
+    try {
+      if (uris.length === 0) {
+        return {
+          success: false,
+          error: 'No files to share',
+        };
+      }
+
+      // Check availability
+      const available = await SharingService.isAvailable();
+      if (!available) {
+        return {
+          success: false,
+          error: 'Sharing is not available on this device',
+        };
+      }
+
+      // Share files sequentially
+      for (const uri of uris) {
+        await Sharing.shareAsync(uri, options);
+      }
+
+      return { success: true };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : 'Failed to share files',
+      };
+    }
+  }
+}

package/src/utilities/sharing/presentation/hooks/useSharing.ts

@@ -0,0 +1,116 @@
+/**
+ * Sharing Domain - useSharing Hook
+ *
+ * React hook for sharing files.
+ * Provides system share sheet functionality with state management.
+ *
+ * @domain sharing
+ * @layer presentation/hooks
+ */
+
+import { useCallback, useMemo } from 'react';
+import { SharingService } from '../../infrastructure/services/SharingService';
+import type { ShareOptions } from '../../domain/entities/Share';
+import { useAsyncOperation } from '../../../../utils/hooks';
+
+/**
+ * useSharing hook for sharing files via system share sheet
+ */
+export const useSharing = () => {
+  // Check availability on mount
+  const availabilityOp = useAsyncOperation<boolean, string>(
+    () => SharingService.isAvailable(),
+    {
+      immediate: true,
+      initialData: false,
+      errorHandler: () => 'Failed to check sharing availability',
+    }
+  );
+
+  // Share operations
+  const shareOp = useAsyncOperation<boolean, string>(
+    async (uri: string, options?: ShareOptions) => {
+      const result = await SharingService.shareFile(uri, options);
+      if (!result.success) {
+        throw new Error(result.error || 'Failed to share file');
+      }
+      return true;
+    },
+    {
+      immediate: false,
+      errorHandler: (err) => err instanceof Error ? err.message : 'Failed to share file',
+    }
+  );
+
+  const shareWithAutoTypeOp = useAsyncOperation<boolean, string>(
+    async (uri: string, filename: string, dialogTitle?: string) => {
+      const result = await SharingService.shareWithAutoType(uri, filename, dialogTitle);
+      if (!result.success) {
+        throw new Error(result.error || 'Failed to share file');
+      }
+      return true;
+    },
+    {
+      immediate: false,
+      errorHandler: (err) => err instanceof Error ? err.message : 'Failed to share file',
+    }
+  );
+
+  const shareMultipleOp = useAsyncOperation<boolean, string>(
+    async (uris: string[], options?: ShareOptions) => {
+      const result = await SharingService.shareMultipleFiles(uris, options);
+      if (!result.success) {
+        throw new Error(result.error || 'Failed to share files');
+      }
+      return true;
+    },
+    {
+      immediate: false,
+      errorHandler: (err) => err instanceof Error ? err.message : 'Failed to share files',
+    }
+  );
+
+  const share = useCallback(
+    async (uri: string, options?: ShareOptions): Promise<boolean> => {
+      const result = await shareOp.execute(uri, options);
+      return result ?? false;
+    },
+    [shareOp]
+  );
+
+  const shareWithAutoType = useCallback(
+    async (uri: string, filename: string, dialogTitle?: string): Promise<boolean> => {
+      const result = await shareWithAutoTypeOp.execute(uri, filename, dialogTitle);
+      return result ?? false;
+    },
+    [shareWithAutoTypeOp]
+  );
+
+  const shareMultiple = useCallback(
+    async (uris: string[], options?: ShareOptions): Promise<boolean> => {
+      const result = await shareMultipleOp.execute(uris, options);
+      return result ?? false;
+    },
+    [shareMultipleOp]
+  );
+
+  return useMemo(() => ({
+    share,
+    shareWithAutoType,
+    shareMultiple,
+    isAvailable: availabilityOp.data ?? false,
+    isSharing: shareOp.isLoading || shareWithAutoTypeOp.isLoading || shareMultipleOp.isLoading,
+    error: shareOp.error || shareWithAutoTypeOp.error || shareMultipleOp.error,
+  }), [
+    share,
+    shareWithAutoType,
+    shareMultiple,
+    availabilityOp.data,
+    shareOp.isLoading,
+    shareWithAutoTypeOp.isLoading,
+    shareMultipleOp.isLoading,
+    shareOp.error,
+    shareWithAutoTypeOp.error,
+    shareMultipleOp.error,
+  ]);
+};