@umituz/react-native-ai-generation-content 1.26.2 → 1.26.4

package/src/features/photo-restoration/index.ts

@@ -1,22 +0,0 @@
-/**
- * Photo Restoration Feature
- * Provider-agnostic photo restoration feature
- */
-
-// Domain Types
-export type {
-  PhotoRestoreOptions,
-  PhotoRestoreRequest,
-  PhotoRestoreResult,
-  PhotoRestoreFeatureState,
-  PhotoRestoreTranslations,
-  PhotoRestoreFeatureConfig,
-  PhotoRestoreResultExtractor,
-} from "./domain";
-
-// Presentation Hooks
-export { usePhotoRestoreFeature, type UsePhotoRestoreFeatureProps } from "./presentation";
-
-// Presentation Components
-export { PhotoRestoreFeature, PhotoRestoreResultView } from "./presentation";
-export type { PhotoRestoreFeatureProps, PhotoRestoreResultViewProps } from "./presentation";

package/src/features/photo-restoration/presentation/components/PhotoRestoreFeature.tsx

@@ -1,88 +0,0 @@
-import React, { useMemo } from "react";
-import { PhotoUploadCard } from "../../../../presentation/components/PhotoUploadCard";
-import { SingleImageFeatureLayout } from "../../../../presentation/layouts";
-import type { SingleImageInputRenderProps, CustomResultRenderProps } from "../../../../presentation/layouts";
-import { PhotoRestoreResultView } from "./PhotoRestoreResultView";
-import { usePhotoRestoreFeature } from "../hooks";
-import type { PhotoRestoreTranslations, PhotoRestoreFeatureConfig } from "../../domain/types";
-
-export interface PhotoRestoreFeatureProps {
-  config: PhotoRestoreFeatureConfig;
-  translations: PhotoRestoreTranslations & {
-    modalTitle?: string;
-    modalMessage?: string;
-    modalHint?: string;
-    modalBackgroundHint?: string;
-  };
-  onSelectImage: () => Promise<string | null>;
-  onSaveImage: (imageUrl: string) => Promise<void>;
-  onBeforeProcess?: () => Promise<boolean>;
-}
-
-export const PhotoRestoreFeature: React.FC<PhotoRestoreFeatureProps> = ({
-  config,
-  translations,
-  onSelectImage,
-  onSaveImage,
-  onBeforeProcess,
-}) => {
-  const feature = usePhotoRestoreFeature({
-    config,
-    onSelectImage,
-    onSaveImage,
-    onBeforeProcess,
-  });
-
-  const modalTranslations = useMemo(
-    () => ({
-      title: translations.modalTitle || "Processing",
-      message: translations.modalMessage || "AI is restoring your photo...",
-      hint: translations.modalHint || "This may take a moment",
-      backgroundHint: translations.modalBackgroundHint || "Continue in background",
-    }),
-    [translations],
-  );
-
-  return (
-    <SingleImageFeatureLayout
-      feature={feature}
-      translations={translations}
-      modalTranslations={modalTranslations}
-      renderInput={({ imageUri, onSelect, isDisabled, isProcessing }: SingleImageInputRenderProps) => (
-        <PhotoUploadCard
-          imageUri={imageUri}
-          onPress={onSelect}
-          isValidating={isProcessing}
-          disabled={isDisabled}
-          translations={{
-            tapToUpload: translations.uploadTitle,
-            selectPhoto: translations.uploadSubtitle,
-            change: translations.uploadChange,
-            analyzing: translations.uploadAnalyzing,
-          }}
-          config={{
-            aspectRatio: 1,
-            borderRadius: 24,
-            showValidationStatus: false,
-            allowChange: true,
-          }}
-        />
-      )}
-      renderCustomResult={({ processedUrl, originalImageUri, onSave, onReset }: CustomResultRenderProps) => (
-        <PhotoRestoreResultView
-          originalUri={originalImageUri}
-          processedUri={processedUrl}
-          translations={{
-            successText: translations.successText,
-            saveButtonText: translations.saveButtonText,
-            tryAnotherText: translations.tryAnotherText,
-            beforeLabel: translations.beforeLabel,
-            afterLabel: translations.afterLabel,
-          }}
-          onSave={onSave}
-          onReset={onReset}
-        />
-      )}
-    />
-  );
-};

package/src/features/photo-restoration/presentation/components/PhotoRestoreResultView.tsx

@@ -1,86 +0,0 @@
-/**
- * PhotoRestoreResultView Component
- * Displays the restored image result with before/after comparison
- */
-
-import React from "react";
-import { StyleSheet } from "react-native";
-import {
-  AtomicText,
-  useAppDesignTokens,
-} from "@umituz/react-native-design-system";
-import { AIGenerationResult } from "../../../../presentation/components/display/AIGenerationResult";
-import { ComparisonSlider } from "../../../upscaling/presentation/components/ComparisonSlider";
-import type { PhotoRestoreTranslations } from "../../domain/types";
-
-export interface PhotoRestoreResultViewProps {
-  originalUri: string;
-  processedUri: string;
-  translations: Pick<
-    PhotoRestoreTranslations,
-    | "successText"
-    | "saveButtonText"
-    | "tryAnotherText"
-    | "beforeLabel"
-    | "afterLabel"
-  >;
-  onSave: () => void;
-  onReset: () => void;
-}
-
-export const PhotoRestoreResultView: React.FC<PhotoRestoreResultViewProps> = ({
-  originalUri,
-  processedUri,
-  translations,
-  onSave,
-  onReset,
-}) => {
-  const tokens = useAppDesignTokens();
-
-  return (
-    <AIGenerationResult
-      successText={translations.successText}
-      primaryAction={{
-        label: translations.saveButtonText,
-        onPress: onSave,
-      }}
-      secondaryAction={{
-        label: translations.tryAnotherText,
-        onPress: onReset,
-      }}
-    >
-      <ComparisonSlider
-        originalUri={originalUri}
-        processedUri={processedUri}
-        beforeLabel={translations.beforeLabel}
-        afterLabel={translations.afterLabel}
-      />
-
-      <AtomicText
-        type="bodySmall"
-        style={[styles.hint, { color: tokens.colors.textSecondary }]}
-      >
-        Drag slider to compare
-      </AtomicText>
-    </AIGenerationResult>
-  );
-};
-
-const styles = StyleSheet.create({
-  container: {
-    flex: 1,
-    paddingHorizontal: 24,
-  },
-  title: {
-    textAlign: "center",
-    marginBottom: 24,
-  },
-  hint: {
-    textAlign: "center",
-    marginTop: 12,
-    marginBottom: 24,
-  },
-  actions: {
-    gap: 12,
-  },
-});

package/src/features/photo-restoration/presentation/components/index.ts

@@ -1,4 +0,0 @@
-export { PhotoRestoreFeature } from "./PhotoRestoreFeature";
-export { PhotoRestoreResultView } from "./PhotoRestoreResultView";
-export type { PhotoRestoreFeatureProps } from "./PhotoRestoreFeature";
-export type { PhotoRestoreResultViewProps } from "./PhotoRestoreResultView";

package/src/features/photo-restoration/presentation/hooks/index.ts

@@ -1 +0,0 @@
-export { usePhotoRestoreFeature, type UsePhotoRestoreFeatureProps } from "./usePhotoRestoreFeature";

package/src/features/photo-restoration/presentation/hooks/usePhotoRestoreFeature.ts

@@ -1,23 +0,0 @@
-/**
- * usePhotoRestoreFeature Hook
- * Uses base single image hook for photo restoration
- */
-
-import { useSingleImageFeature, type BaseSingleImageHookReturn } from "../../../image-to-image";
-import type { PhotoRestoreFeatureConfig } from "../../domain/types";
-
-export interface UsePhotoRestoreFeatureProps {
-  config: PhotoRestoreFeatureConfig;
-  onSelectImage: () => Promise<string | null>;
-  onSaveImage: (imageUrl: string) => Promise<void>;
-  onBeforeProcess?: () => Promise<boolean>;
-}
-
-export function usePhotoRestoreFeature(props: UsePhotoRestoreFeatureProps): BaseSingleImageHookReturn {
-  const { config, onSelectImage, onSaveImage, onBeforeProcess } = props;
-
-  return useSingleImageFeature<PhotoRestoreFeatureConfig>(
-    { config: config as never, onSelectImage, onSaveImage, onBeforeProcess },
-    { buildInput: (imageBase64) => ({ imageBase64 }) },
-  );
-}

package/src/features/photo-restoration/presentation/index.ts

@@ -1,2 +0,0 @@
-export * from "./hooks";
-export * from "./components";

package/src/features/remove-background/README.md

@@ -1,393 +0,0 @@
-# Remove Background Feature
-
-Remove backgrounds from images using AI with precision.
-
-## 📍 Import Path
-
-```typescript
-import { useRemoveBackgroundFeature } from '@umituz/react-native-ai-generation-content';
-```
-
-**Location**: `src/features/remove-background/`
-
-## 🎯 Feature Purpose
-
-Automatically detect and remove backgrounds from images using AI. Keeps main subjects while removing backgrounds, handling complex edges like hair, fur, and transparent objects.
-
----
-
-## 📋 Usage Strategy
-
-### When to Use This Feature
-
-✅ **Use Cases:**
-- Product photography for e-commerce
-- Creating transparent images for design
-- Profile picture background removal
-- Preparing images for marketing materials
-- Isolating subjects for compositing
-- Creating stickers and overlays
-
-❌ **When NOT to Use:**
-- Manual background selection (use image editing software)
-- Background replacement (use Replace Background)
-- Object removal from photos (use Remove Object)
-- Photo restoration (use Photo Restoration)
-
-### Implementation Strategy
-
-1. **Upload image** with clear subject
-2. **Preview detection** before processing
-3. **Choose edge smoothness** level
-4. **Show before/after comparison** with transparency
-5. **Provide download** as transparent PNG
-6. **Offer fine-tuning** options for edges
-
----
-
-## ⚠️ Critical Rules (MUST FOLLOW)
-
-### 1. Image Requirements
-- **MUST** provide ONE image to process
-- **MUST** have clear subject in image
-- **MUST** use reasonable resolution (min 512x512)
-- **MUST** use supported formats (JPEG, PNG)
-- **MUST NOT** exceed file size limits (10MB max)
-
-### 2. Configuration
-- **MUST** provide valid `userId` for tracking
-- **MUST** specify `edgeSmoothness` (low, medium, high)
-- **MUST** implement `onError` callback
-- **MUST** implement `onSelectImage` callback
-- **MUST** handle transparent PNG output
-
-### 3. State Management
-- **MUST** check `isReady` before enabling remove button
-- **MUST** display progress during processing
-- **MUST** handle transparency display properly
-- **MUST** display `error` state with clear messages
-- **MUST** implement proper cleanup on unmount
-
-### 4. Performance
-- **MUST** implement image compression before upload
-- **MUST** show progress indicator for processing
-- **MUST** cache results locally
-- **MUST** handle large output images
-- **MUST NOT** process multiple images simultaneously
-
-### 5. User Experience
-- **MUST** show background preview with transparency grid
-- **MUST** provide before/after comparison
-- **MUST** offer edge smoothness options
-- **MUST** handle complex subjects (hair, fur)
-- **MUST** provide download as PNG
-
----
-
-## 🚫 Prohibitions (MUST AVOID)
-
-### Strictly Forbidden
-
-❌ **NEVER** do the following:
-
-1. **No Missing Images**
-   - Always validate image is selected
-   - Never call process() without image
-
-2. **No Auto-Processing**
-   - Never start removal without user action
-   - Always require explicit "Remove Background" button press
-   - Provide clear preview before processing
-
-3. **No Hardcoded Credentials**
-   - Never store API keys in component files
-   - Use environment variables or secure storage
-
-4. **No Unhandled Errors**
-   - Never ignore detection failures
-   - Always explain what went wrong
-   - Provide retry or alternative options
-
-5. **No Memory Leaks**
-   - Never store large images unnecessarily
-   - Clean up temporary images
-   - Implement proper image disposal
-
-6. **No Blocking UI**
-   - Never block main thread with image processing
-   - Always show progress indicator
-   - Allow cancellation
-
-7. **No Poor Quality Output**
-   - Never compress PNG output excessively
-   - Preserve transparency quality
-   - Use appropriate edge settings
-
----
-
-## 🤖 AI Agent Directions
-
-### For AI Code Generation Tools
-
-When using this feature with AI code generation tools, follow these guidelines:
-
-#### Prompt Template for AI Agents
-
-```
-You are implementing a background removal feature using @umituz/react-native-ai-generation-content.
-
-REQUIREMENTS:
-1. Import from: @umituz/react-native-ai-generation-content
-2. Use the useRemoveBackgroundFeature hook
-3. Select edge smoothness level
-4. Implement image selection UI
-5. Validate image before processing
-6. Show before/after comparison with transparency
-7. Display result on transparency grid
-8. Implement proper error handling
-9. Provide PNG download
-10. Implement cleanup on unmount
-
-CRITICAL RULES:
-- MUST validate image before calling remove()
-- MUST show before/after comparison
-- MUST display transparency grid properly
-- MUST handle complex subjects (hair, fur)
-- MUST implement debouncing (300ms)
-- MUST provide PNG format output
-
-CONFIGURATION:
-- Provide valid userId (string)
-- Set edgeSmoothness: 'low' | 'medium' | 'high'
-- Implement onSelectImage callback
-- Implement onSaveImage callback
-- Configure callbacks: onProcessingStart, onProcessingComplete, onError
-
-OPTIONS:
-- edgeSmoothness: 'low' | 'medium' | 'high'
-  - Low: Sharper edges, better for objects
-  - Medium: Balanced (recommended)
-  - High: Smoother edges, better for hair/fur
-
-STRICTLY FORBIDDEN:
-- No missing image validation
-- No auto-processing without user action
-- No hardcoded API keys
-- No unhandled errors
-- No memory leaks
-- No blocking UI
-- No poor quality PNG output
-
-QUALITY CHECKLIST:
-- [ ] Image selection implemented
-- [ ] Edge smoothness selector
-- [ ] Transparency grid display
-- [ ] Before/after comparison view
-- [ ] Progress indicator during processing
-- [ ] Error display with retry option
-- [ ] PNG download functionality
-- [ ] Original image preserved
-```
-
-#### AI Implementation Checklist
-
-Use this checklist when generating code:
-
-- [ ] Feature imported from correct path
-- [ ] Image selection implemented
-- [ ] Edge smoothness selector added
-- [ ] Validation before remove()
-- [ ] Transparency grid for result display
-- [ ] Before/after comparison view
-- [ ] Progress indicator during processing
-- [ ] Error display with user-friendly message
-- [ ] PNG download with transparency
-- [ ] Cleanup on unmount
-- [ ] Original image preserved
-- [ ] Complex subject handling
-
----
-
-## 🛠️ Configuration Strategy
-
-### Essential Configuration
-
-```typescript
-// Required fields
-{
-  userId: string
-  edgeSmoothness: 'low' | 'medium' | 'high'
-  onSelectImage: () => Promise<string | null>
-}
-
-// Optional callbacks
-{
-  onProcessingStart?: () => void
-  onProcessingComplete?: (result) => void
-  onError?: (error: string) => void
-}
-```
-
-### Recommended Settings
-
-1. **Edge Smoothness**
-   - Low: Sharp edges, best for simple objects
-   - Medium: Balanced (recommended for most cases)
-   - High: Smooth edges, best for hair, fur, complex subjects
-
-2. **Image Quality**
-   - Minimum: 512x512 resolution
-   - Recommended: 1024x1024 or higher
-   - Format: JPEG or PNG
-   - Max size: 10MB
-
-3. **Performance Settings**
-   - Compress images before upload
-   - Show progress for operations
-   - Implement timeout (60s default)
-   - Enable result caching
-
----
-
-## 📊 State Management
-
-### Feature States
-
-**isReady**: boolean
-- Image selected and validated
-- Check before enabling remove button
-
-**isProcessing**: boolean
-- Background removal in progress
-- Show loading/progress indicator
-- Disable remove button
-
-**progress**: number (0-100)
-- Processing progress percentage
-- Update progress bar
-
-**error**: string | null
-- Error message if processing failed
-- Display to user with clear message
-
-**result**: {
-  imageUrl: string  // Transparent PNG
-  originalImageUrl?: string
-  edgeSmoothness?: string
-  metadata?: any
-}
-
----
-
-## 🎨 Best Practices
-
-### Image Selection
-
-1. **Subject Clarity**
-   - Good: Clear separation between subject and background
-   - Bad: Similar colors, low contrast between subject and background
-
-2. **Lighting**
-   - Good: Even lighting on subject
-   - Bad: Harsh shadows, complex backgrounds
-
-3. **Edge Complexity**
-   - Simple objects: Use low edge smoothness
-   - Hair/fur: Use high edge smoothness
-   - Mixed: Use medium edge smoothness
-
-### User Experience
-
-1. **Transparency Display**
-   - Show checkerboard pattern for transparency
-   - Allow background color preview
-   - Provide zoom for edge inspection
-
-2. **Comparison Tools**
-   - Before/after slider
-   - Toggle original/removed
-   - Edge detail zoom
-
-3. **Output Quality**
-   - Always provide PNG format
-   - Preserve edge quality
-   - Offer multiple resolution options
-
----
-
-## 🐛 Common Pitfalls
-
-### Detection Issues
-
-❌ **Problem**: Background not fully removed
-✅ **Solution**: Ensure good subject-background contrast, try different edge smoothness
-
-### Edge Quality Issues
-
-❌ **Problem**: Jagged or unnatural edges
-✅ **Solution**: Adjust edge smoothness, use higher setting for hair/fur
-
-### Transparency Issues
-
-❌ **Problem**: Transparency not visible
-✅ **Solution**: Display with checkerboard pattern, offer background preview
-
-### Performance Issues
-
-❌ **Problem**: Slow processing
-✅ **Solution**: Compress images, show progress, implement timeout
-
----
-
-## 📦 Related Components
-
-Use these components from the library:
-
-- **PhotoUploadCard**: Upload image interface
-- **ResultDisplay**: Before/after comparison
-- **TransparencyGrid**: Display transparent images
-- **EdgeSmoothnessSelector**: Choose edge quality
-- **ProgressBar**: Progress display
-
-Located at: `src/presentation/components/`
-
----
-
-## 🔄 Migration Strategy
-
-If migrating from previous implementation:
-
-1. **Update imports** to new path
-2. **Add edge smoothness selector**
-3. **Implement transparency grid display**
-4. **Update state handling** for new structure
-5. **Add before/after comparison**
-6. **Test with complex subjects**
-
----
-
-## 📚 Additional Resources
-
-- Main documentation: `/docs/`
-- API reference: `/docs/api/`
-- Examples: `/docs/examples/basic/remove-background/`
-- Architecture: `/ARCHITECTURE.md`
-
----
-
-**Last Updated**: 2025-01-08
-**Version**: 2.0.0 (Strategy-based Documentation)
-
----
-
-## 📝 Changelog
-
-### v2.0.0 - 2025-01-08
-- **BREAKING**: Documentation format changed to strategy-based
-- Removed extensive code examples
-- Added rules, prohibitions, and AI agent directions
-- Focus on best practices and implementation guidance
-- Added transparency handling guidelines
-
-### v1.0.0 - Initial Release
-- Initial feature documentation

package/src/features/remove-background/domain/index.ts

@@ -1,5 +0,0 @@
-/**
- * Remove Background Domain Index
- */
-
-export * from "./types";

package/src/features/remove-background/domain/types/index.ts

@@ -1,7 +0,0 @@
-export type {
-  RemoveBackgroundOptions,
-  RemoveBackgroundResult,
-  RemoveBackgroundFeatureState,
-  RemoveBackgroundTranslations,
-  RemoveBackgroundFeatureConfig,
-} from "./remove-background.types";

package/src/features/remove-background/domain/types/remove-background.types.ts

@@ -1,28 +0,0 @@
-/**
- * Remove Background Feature Types
- * Extends base image-to-image types with remove-background options
- */
-
-import type {
-  BaseImageResult,
-  BaseSingleImageState,
-  BaseImageTranslations,
-  SingleImageConfig,
-} from "../../../image-to-image/domain/types";
-
-export interface RemoveBackgroundOptions {
-  refineEdges?: boolean;
-  outputFormat?: "png" | "webp";
-  backgroundColor?: string;
-}
-
-export type RemoveBackgroundResult = BaseImageResult;
-
-export type RemoveBackgroundFeatureState = BaseSingleImageState;
-
-export type RemoveBackgroundTranslations = BaseImageTranslations;
-
-export interface RemoveBackgroundFeatureConfig
-  extends SingleImageConfig<RemoveBackgroundResult> {
-  defaultOptions?: RemoveBackgroundOptions;
-}

package/src/features/remove-background/index.ts

@@ -1,19 +0,0 @@
-/**
- * Remove Background Feature
- * Provider-agnostic background removal feature
- */
-
-// Domain Types
-export type {
-  RemoveBackgroundOptions,
-  RemoveBackgroundResult,
-  RemoveBackgroundFeatureState,
-  RemoveBackgroundTranslations,
-  RemoveBackgroundFeatureConfig,
-} from "./domain";
-
-// Presentation Hooks
-export { useRemoveBackgroundFeature, type UseRemoveBackgroundFeatureProps } from "./presentation";
-
-// Presentation Components
-export { RemoveBackgroundFeature, type RemoveBackgroundFeatureProps } from "./presentation";