@umituz/react-native-design-system 4.28.6 → 4.28.8

package/dist/filesystem/domain/types/FileTypes.d.ts

@@ -1,38 +0,0 @@
-/**
- * File Types
- * Domain layer type definitions for file operations
- */
-/**
- * File encoding types supported by expo-file-system
- */
-export type FileEncoding = 'utf8' | 'base64';
-/**
- * Directory types available in expo-file-system
- */
-export type DirectoryType = 'documentDirectory' | 'cacheDirectory';
-/**
- * Result of a file operation
- */
-export interface FileOperationResult {
-    success: boolean;
-    uri?: string;
-    error?: string;
-}
-/**
- * File information metadata
- */
-export interface FileInfo {
-    uri: string;
-    name?: string;
-    size: number;
-    exists: boolean;
-    isDirectory: boolean;
-    modificationTime?: number;
-}
-/**
- * Download progress information
- */
-export interface DownloadProgress {
-    totalBytesWritten: number;
-    totalBytesExpectedToWrite: number;
-}

package/dist/filesystem/domain/utils/FileUtils.d.ts

@@ -1,41 +0,0 @@
-/**
- * File Utils
- * File utility functions for common operations
- */
-/**
- * File utility functions
- */
-export declare class FileUtils {
-    /**
-     * Format file size in bytes to human-readable format
-     */
-    static formatFileSize(bytes: number): string;
-    /**
-     * Generate unique filename with timestamp
-     */
-    static generateUniqueFilename(filename: string): string;
-    /**
-     * Sanitize filename by removing invalid characters
-     */
-    static sanitizeFilename(filename: string): string;
-    /**
-     * Join path segments
-     */
-    static joinPaths(...segments: string[]): string;
-    /**
-     * Get file extension from filename
-     */
-    static getFileExtension(filename: string): string;
-    /**
-     * Check if file extension is allowed
-     */
-    static isAllowedExtension(filename: string): boolean;
-    /**
-     * Get filename from URI
-     */
-    static getFilenameFromUri(uri: string): string;
-    /**
-     * Validate file size
-     */
-    static isValidFileSize(size: number): boolean;
-}

package/dist/filesystem/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * @filesystem
- */
-export type { FileEncoding, DirectoryType, FileOperationResult, FileInfo, DownloadProgress } from "./domain/entities/File";
-export { FILE_CONSTANTS, FileUtils } from "./domain/entities/File";
-export type { DownloadProgressCallback, DownloadWithProgressResult } from "./infrastructure/services/download.types";
-export { downloadFile, downloadFileWithProgress, isUrlCached, getCachedFileUri, deleteCachedFile } from "./infrastructure/services/download.service";
-export { getCacheDirectory, getDocumentDirectory, createDirectory } from "./infrastructure/services/directory.service";
-export { FileSystemService } from "./infrastructure/services/FileSystemService";
-export { fileExists, getFileInfo } from "./infrastructure/services/file-info.service";
-export { deleteFile } from "./infrastructure/services/file-manager.service";
-export { clearCache } from "./infrastructure/services/cache.service";
-export { readFile, readFileAsBase64 } from "./infrastructure/services/file-reader.service";
-export { extractBase64FromDataUri, detectMimeType, getExtensionFromMimeType, base64ToTempFile, deleteTempFile, getFileSize, } from "./infrastructure/utils/blob.utils";

package/dist/filesystem/infrastructure/services/FileSystemService.d.ts

@@ -1,34 +0,0 @@
-/**
- * FileSystem Service - Facade
- */
-import { readFile, readFileAsBase64 } from "./file-reader.service";
-import { writeFile } from "./file-writer.service";
-import { deleteFile, copyFile, moveFile } from "./file-manager.service";
-import { createDirectory, listDirectory, getDirectoryPath, getDocumentDirectory, getCacheDirectory } from "./directory.service";
-import { getFileInfo, fileExists, getFileSize } from "./file-info.service";
-import { downloadFile } from "./download.service";
-import { clearCache, getDirectorySize } from "./cache.service";
-import { generateFilePath } from "./file-path.service";
-import type { FileOperationResult } from "../../domain/entities/File";
-export declare class FileSystemService {
-    static readFile: typeof readFile;
-    static readFileAsBase64: typeof readFileAsBase64;
-    static writeFile: typeof writeFile;
-    static deleteFile: typeof deleteFile;
-    static copyFile: typeof copyFile;
-    static moveFile: typeof moveFile;
-    static createDirectory: typeof createDirectory;
-    static listDirectory: typeof listDirectory;
-    static getDirectoryPath: typeof getDirectoryPath;
-    static getDocumentDirectory: typeof getDocumentDirectory;
-    static getCacheDirectory: typeof getCacheDirectory;
-    static getFileInfo: typeof getFileInfo;
-    static exists: typeof fileExists;
-    static getFileSize: typeof getFileSize;
-    static downloadFile: typeof downloadFile;
-    static clearCache: typeof clearCache;
-    static getDirectorySize: typeof getDirectorySize;
-    static generateFilePath: typeof generateFilePath;
-    static copyToCache(sourceUri: string, filename?: string): Promise<FileOperationResult>;
-    static copyToDocuments(sourceUri: string, filename?: string): Promise<FileOperationResult>;
-}

package/dist/filesystem/infrastructure/services/cache.service.d.ts

@@ -1,12 +0,0 @@
-/**
- * Cache Service
- * Single Responsibility: Manage cache directory operations
- */
-/**
- * Clear cache directory
- */
-export declare function clearCache(): Promise<boolean>;
-/**
- * Get total size of directory
- */
-export declare function getDirectorySize(uri: string): Promise<number>;

package/dist/filesystem/infrastructure/services/directory.service.d.ts

@@ -1,25 +0,0 @@
-/**
- * Directory Service
- * Single Responsibility: Manage directory operations
- */
-import type { DirectoryType } from "../../domain/entities/File";
-/**
- * Create directory
- */
-export declare function createDirectory(uri: string): Promise<boolean>;
-/**
- * List directory contents
- */
-export declare function listDirectory(uri: string): Promise<string[]>;
-/**
- * Get directory path by type
- */
-export declare function getDirectoryPath(type: DirectoryType): string;
-/**
- * Get document directory path
- */
-export declare function getDocumentDirectory(): string;
-/**
- * Get cache directory path
- */
-export declare function getCacheDirectory(): string;

package/dist/filesystem/infrastructure/services/download.constants.d.ts

@@ -1,5 +0,0 @@
-/**
- * Download Service Constants
- */
-export declare const SUPPORTED_DOWNLOAD_EXTENSIONS: readonly ["mp4", "mov", "m4v", "webm", "jpg", "png", "pdf"];
-export declare const DEFAULT_DOWNLOAD_EXTENSION: "mp4";

package/dist/filesystem/infrastructure/services/download.service.d.ts

@@ -1,10 +0,0 @@
-/**
- * Download Service
- */
-import type { FileOperationResult } from "../../domain/entities/File";
-import type { DownloadProgressCallback, DownloadWithProgressResult } from "./download.types";
-export declare function downloadFile(url: string, dest?: string): Promise<FileOperationResult>;
-export declare function downloadFileWithProgress(url: string, cacheDir: string, onProgress?: DownloadProgressCallback, signal?: AbortSignal): Promise<DownloadWithProgressResult>;
-export declare const isUrlCached: (url: string, dir: string) => boolean;
-export declare const getCachedFileUri: (url: string, dir: string) => string | null;
-export declare const deleteCachedFile: (url: string, dir: string) => Promise<boolean>;

package/dist/filesystem/infrastructure/services/download.types.d.ts

@@ -1,5 +0,0 @@
-import type { FileOperationResult, DownloadProgress } from "../../domain/entities/File";
-export type DownloadProgressCallback = (progress: DownloadProgress) => void;
-export interface DownloadWithProgressResult extends FileOperationResult {
-    fromCache?: boolean;
-}

package/dist/filesystem/infrastructure/services/encoding.service.d.ts

@@ -1,17 +0,0 @@
-/**
- * Encoding Service
- * Single Responsibility: Handle file encoding/decoding operations
- */
-import type { FileEncoding } from "../../domain/entities/File";
-/**
- * Encoding type for Expo FileSystem
- */
-export type ExpoEncodingType = FileEncoding;
-/**
- * Convert FileEncoding to Expo FileSystem encoding type
- */
-export declare function getEncodingType(encoding: FileEncoding): ExpoEncodingType;
-/**
- * Validate encoding type
- */
-export declare function isValidEncoding(encoding: string): encoding is FileEncoding;

package/dist/filesystem/infrastructure/services/file-info.service.d.ts

@@ -1,17 +0,0 @@
-/**
- * File Info Service
- * Single Responsibility: Get file information and metadata
- */
-import type { FileInfo } from "../../domain/entities/File";
-/**
- * Get file information
- */
-export declare function getFileInfo(uri: string): Promise<FileInfo | null>;
-/**
- * Check if file exists
- */
-export declare function fileExists(uri: string): Promise<boolean>;
-/**
- * Get file size
- */
-export declare function getFileSize(uri: string): Promise<number>;

package/dist/filesystem/infrastructure/services/file-manager.service.d.ts

@@ -1,17 +0,0 @@
-/**
- * File Manager Service
- * Single Responsibility: Manage file operations (delete, copy, move)
- */
-import type { FileOperationResult } from "../../domain/entities/File";
-/**
- * Delete file or directory
- */
-export declare function deleteFile(uri: string): Promise<boolean>;
-/**
- * Copy file
- */
-export declare function copyFile(sourceUri: string, destinationUri: string): Promise<FileOperationResult>;
-/**
- * Move file
- */
-export declare function moveFile(sourceUri: string, destinationUri: string): Promise<FileOperationResult>;

package/dist/filesystem/infrastructure/services/file-path.service.d.ts

@@ -1,9 +0,0 @@
-/**
- * File Path Service
- * Single Responsibility: Generate and manage file paths
- */
-import type { DirectoryType } from "../../domain/entities/File";
-/**
- * Generate unique file path in specified directory
- */
-export declare function generateFilePath(filename: string, directory?: DirectoryType): string;

package/dist/filesystem/infrastructure/services/file-reader.service.d.ts

@@ -1,13 +0,0 @@
-/**
- * File Reader Service
- * Single Responsibility: Read files from device storage
- */
-import type { FileEncoding } from "../../domain/entities/File";
-/**
- * Read file as string with encoding
- */
-export declare function readFile(uri: string, encoding?: FileEncoding): Promise<string | null>;
-/**
- * Read file as base64 string
- */
-export declare function readFileAsBase64(uri: string): Promise<string | null>;

package/dist/filesystem/infrastructure/services/file-writer.service.d.ts

@@ -1,9 +0,0 @@
-/**
- * File Writer Service
- * Single Responsibility: Write files to device storage
- */
-import type { FileEncoding, FileOperationResult } from "../../domain/entities/File";
-/**
- * Write string to file
- */
-export declare function writeFile(uri: string, content: string, encoding?: FileEncoding): Promise<FileOperationResult>;

package/dist/filesystem/infrastructure/utils/blob.utils.d.ts

@@ -1,29 +0,0 @@
-/**
- * Blob Utils
- * Base64 and file utility functions for React Native
- */
-/**
- * Extract raw base64 from data URI
- */
-export declare function extractBase64FromDataUri(dataUri: string): string;
-/**
- * Detect MIME type from data URI or base64
- */
-export declare function detectMimeType(base64: string): string;
-/**
- * Get file extension from MIME type
- */
-export declare function getExtensionFromMimeType(mimeType: string): string;
-/**
- * Write base64 to a temp file and return the file URI
- * This is React Native compatible (no Blob/ArrayBuffer needed)
- */
-export declare function base64ToTempFile(base64: string, filename?: string): Promise<string>;
-/**
- * Delete a temp file
- */
-export declare function deleteTempFile(uri: string): Promise<void>;
-/**
- * Get file size from URI
- */
-export declare function getFileSize(uri: string): number;

package/dist/gallery/gallery-download.service.d.ts

@@ -1,12 +0,0 @@
-/**
- * Gallery Download Service
- * Single Responsibility: Download remote media to local storage
- */
-import type { DownloadMediaResult } from "./types";
-declare class GalleryDownloadService {
-    downloadMedia(mediaUri: string, prefix?: string): Promise<DownloadMediaResult>;
-    isRemoteUrl(uri: string): boolean;
-    cleanupFile(fileUri: string): Promise<void>;
-}
-export declare const galleryDownloadService: GalleryDownloadService;
-export {};

package/dist/gallery/gallery-save.service.d.ts

@@ -1,10 +0,0 @@
-/**
- * Gallery Save Service
- * Single Responsibility: Save media to device gallery
- */
-import type { SaveMediaResult } from "./types";
-declare class GallerySaveService {
-    saveToGallery(mediaUri: string, prefix?: string): Promise<SaveMediaResult>;
-}
-export declare const gallerySaveService: GallerySaveService;
-export {};

package/dist/gallery/index.d.ts

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

package/dist/gallery/types.d.ts

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

package/dist/haptics/domain/entities/Haptic.d.ts

@@ -1,45 +0,0 @@
-/**
- * Haptics Domain - Core Entities
- *
- * This file defines core types and interfaces for haptic feedback.
- * Handles vibration patterns and feedback types using expo-haptics.
- *
- * @domain haptics
- * @layer domain/entities
- */
-/**
- * Impact feedback style (compatible with expo-haptics)
- */
-export type ImpactStyle = 'Light' | 'Medium' | 'Heavy' | 'Rigid' | 'Soft';
-/**
- * Notification feedback type (compatible with expo-haptics)
- */
-export type NotificationType = 'Success' | 'Warning' | 'Error';
-/**
- * Haptic patterns for common interactions
- */
-export type HapticPattern = 'success' | 'warning' | 'error' | 'selection';
-/**
- * Haptic constants
- */
-export declare const HAPTIC_CONSTANTS: {
-    readonly DEFAULT_IMPACT: ImpactStyle;
-    readonly BUTTON_IMPACT: ImpactStyle;
-    readonly DELETE_IMPACT: ImpactStyle;
-    readonly ERROR_IMPACT: ImpactStyle;
-};
-/**
- * Type guards for runtime type safety
- */
-/**
- * Check if value is a valid ImpactStyle
- */
-export declare function isImpactStyle(value: unknown): value is ImpactStyle;
-/**
- * Check if value is a valid NotificationType
- */
-export declare function isNotificationType(value: unknown): value is NotificationType;
-/**
- * Check if value is a valid HapticPattern
- */
-export declare function isHapticPattern(value: unknown): value is HapticPattern;

package/dist/haptics/index.d.ts

@@ -1,156 +0,0 @@
-/**
- * Haptics Domain - Barrel Export
- *
- * Provides haptic feedback (vibration) using expo-haptics.
- * Universal domain - enabled by default for UX improvement.
- *
- * @domain haptics
- * @enabled true (All apps - UX improvement)
- *
- * ARCHITECTURE:
- * - Domain Layer: Entities (haptic types, patterns, utilities)
- * - Infrastructure Layer: Services (HapticService)
- * - Presentation Layer: Hooks (useHaptics)
- *
- * DEPENDENCIES:
- * - expo-haptics (vibration patterns)
- *
- * FEATURES:
- * - Impact feedback (light, medium, heavy)
- * - Notification feedback (success, warning, error)
- * - Selection feedback (pickers, sliders)
- * - Custom haptic patterns
- * - Convenience methods for common interactions
- *
- * USAGE:
- *
- * Basic Haptics:
- * ```typescript
- * import { useHaptics } from '@umituz/react-native-haptics';
- *
- * const haptics = useHaptics();
- *
- * // Button press
- * <TouchableOpacity onPress={() => haptics.buttonPress()}>
- *   <Text>Click Me</Text>
- * </TouchableOpacity>
- *
- * // Success feedback
- * const handleSave = async () => {
- *   await saveData();
- *   haptics.success();
- * };
- *
- * // Error feedback
- * haptics.error();
- * ```
- *
- * Selection Change (Sliders, Pickers):
- * ```typescript
- * import { useHaptics } from '@umituz/react-native-haptics';
- *
- * const haptics = useHaptics();
- *
- * <Slider
- *   value={value}
- *   onValueChange={(val) => {
- *     setValue(val);
- *     haptics.selectionChange();
- *   }}
- * />
- * ```
- *
- * Custom Patterns:
- * ```typescript
- * import { useHaptics } from '@umituz/react-native-haptics';
- *
- * const haptics = useHaptics();
- *
- * // Impact with specific style
- * haptics.impact('heavy');
- *
- * // Notification with specific type
- * haptics.notification('warning');
- *
- * // Custom pattern
- * haptics.pattern('long_press');
- * ```
- *
- * Direct Service Usage (Rare):
- * ```typescript
- * import { HapticService } from '@umituz/react-native-haptics';
- *
- * // Use when you can't use hooks (outside components)
- * await HapticService.buttonPress();
- * await HapticService.success();
- * ```
- *
- * Common Patterns:
- * ```typescript
- * import { useHaptics } from '@umituz/react-native-haptics';
- *
- * const haptics = useHaptics();
- *
- * // Button press (light impact)
- * haptics.buttonPress();
- *
- * // Success (notification feedback)
- * haptics.success();
- *
- * // Error (notification feedback)
- * haptics.error();
- *
- * // Warning (notification feedback)
- * haptics.warning();
- *
- * // Delete (medium impact)
- * haptics.delete();
- *
- * // Refresh (medium impact)
- * haptics.refresh();
- *
- * // Selection change (selection feedback)
- * haptics.selectionChange();
- *
- * // Long press (heavy impact)
- * haptics.longPress();
- * ```
- *
- * Utilities:
- * ```typescript
- * import { HapticUtils } from '@umituz/react-native-haptics';
- *
- * // Get impact style for pattern
- * const style = HapticUtils.getImpactForPattern('button_press'); // 'light'
- *
- * // Get notification type for pattern
- * const type = HapticUtils.getNotificationForPattern('success'); // 'success'
- *
- * // Check if pattern should use notification
- * const shouldUse = HapticUtils.shouldUseNotification('success'); // true
- * ```
- *
- * BENEFITS:
- * - Improved UX with tactile feedback
- * - Consistent haptic patterns across app
- * - Silent failure (no crashes if unsupported)
- * - Platform-agnostic (iOS + Android)
- * - Easy integration in any component
- * - Works across all apps
- *
- * USE CASES:
- * - Button presses
- * - Success confirmations
- * - Error alerts
- * - Selection changes (sliders, pickers)
- * - Delete actions
- * - Refresh actions
- * - Long press gestures
- * - Form validation feedback
- *
- * @see https://docs.expo.dev/versions/latest/sdk/haptics/
- */
-export type { ImpactStyle, NotificationType, HapticPattern, } from './domain/entities/Haptic';
-export { HAPTIC_CONSTANTS, isImpactStyle, isNotificationType, isHapticPattern, } from './domain/entities/Haptic';
-export { HapticService } from './infrastructure/services/HapticService';
-export { useHaptics } from './presentation/hooks/useHaptics';

package/dist/haptics/infrastructure/services/HapticService.d.ts

@@ -1,44 +0,0 @@
-/**
- * Haptics Domain - Haptic Service
- *
- * Service for haptic feedback using expo-haptics (optional peer dep).
- * Falls back to noop when expo-haptics is not installed or haptics are disabled.
- *
- * LAZY LOADING:
- * expo-haptics is only required at runtime when a haptic is triggered AND enabled.
- * Apps that don't need haptics pay zero cost — no require() is ever called.
- *
- * USAGE:
- * // Opt out entirely (e.g. tablet apps, web, or apps without expo-haptics):
- * HapticService.configure({ enabled: false })
- *
- * // Opt in (default):
- * HapticService.configure({ enabled: true })
- */
-import type { ImpactStyle, NotificationType, HapticPattern } from '../../domain/entities/Haptic';
-export declare class HapticService {
-    /**
-     * Configure haptics at the app level.
-     * Call once at startup — before any haptic is triggered.
-     *
-     * @param enabled - false to silently disable all haptics (no expo-haptics required).
-     *                  Defaults to true.
-     */
-    static configure({ enabled }: {
-        enabled: boolean;
-    }): void;
-    static impact(style?: ImpactStyle): Promise<void>;
-    static notification(type: NotificationType): Promise<void>;
-    static selection(): Promise<void>;
-    static pattern(pattern: HapticPattern): Promise<void>;
-    static buttonPress(): Promise<void>;
-    static success(): Promise<void>;
-    static error(): Promise<void>;
-    static warning(): Promise<void>;
-    static delete(): Promise<void>;
-    static refresh(): Promise<void>;
-    static selectionChange(): Promise<void>;
-    static longPress(): Promise<void>;
-    static rigid(): Promise<void>;
-    static soft(): Promise<void>;
-}

package/dist/haptics/presentation/hooks/useHaptics.d.ts

@@ -1,56 +0,0 @@
-/**
- * Haptics Domain - useHaptics Hook
- *
- * React hook for haptic feedback.
- * Provides vibration patterns for common interactions.
- *
- * @domain haptics
- * @layer presentation/hooks
- */
-import type { ImpactStyle, NotificationType, HapticPattern } from '../../domain/entities/Haptic';
-/**
- * useHaptics hook for haptic feedback
- *
- * USAGE:
- * ```typescript
- * const haptics = useHaptics();
- *
- * // Common patterns (convenience methods)
- * <TouchableOpacity onPress={() => haptics.buttonPress()}>
- *   <Text>Click Me</Text>
- * </TouchableOpacity>
- *
- * // Success feedback
- * const handleSuccess = async () => {
- *   await saveData();
- *   haptics.success();
- * };
- *
- * // Error feedback
- * const handleError = () => {
- *   haptics.error();
- * };
- *
- * // Selection change (sliders, pickers)
- * <Slider onValueChange={() => haptics.selectionChange()} />
- *
- * // Custom patterns
- * haptics.pattern('long_press');
- * haptics.impact('heavy');
- * haptics.notification('warning');
- * ```
- */
-export declare const useHaptics: () => {
-    impact: (style?: ImpactStyle) => Promise<void>;
-    notification: (type: NotificationType) => Promise<void>;
-    selection: () => Promise<void>;
-    pattern: (patternType: HapticPattern) => Promise<void>;
-    buttonPress: () => Promise<void>;
-    success: () => Promise<void>;
-    error: () => Promise<void>;
-    warning: () => Promise<void>;
-    delete: () => Promise<void>;
-    refresh: () => Promise<void>;
-    selectionChange: () => Promise<void>;
-    longPress: () => Promise<void>;
-};