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

package/src/features/partner-upload/presentation/screens/PartnerStepScreen.tsx

@@ -1,231 +0,0 @@
-/**
- * PartnerStepScreen
- * Generic partner/photo upload screen
- */
-
-import React, { useMemo } from "react";
-import { View, TouchableOpacity, StyleSheet } from "react-native";
-import {
-  useAppDesignTokens,
-  ScreenLayout,
-  AtomicText,
-  AtomicIcon,
-  NavigationHeader,
-  type DesignTokens,
-} from "@umituz/react-native-design-system";
-import { PhotoUploadCard } from "../../../../presentation/components";
-import { FaceDetectionToggle } from "../../../../domains/face-detection";
-import { PhotoTips } from "../components/PhotoTips";
-import { PartnerInfoInput } from "../components/PartnerInfoInput";
-import { usePartnerStep } from "../hooks/usePartnerStep";
-import type { UploadedImage } from "../../domain/types";
-
-export interface PartnerStepScreenTranslations {
-  readonly title: string;
-  readonly subtitle: string;
-  readonly continue: string;
-  readonly tapToUpload: string;
-  readonly selectPhoto: string;
-  readonly change: string;
-  readonly analyzing: string;
-  readonly faceDetectionLabel?: string;
-  readonly fileTooLarge: string;
-  readonly maxFileSize: string;
-  readonly error: string;
-  readonly uploadFailed: string;
-  readonly aiDisclosure?: string;
-}
-
-export interface PartnerStepScreenConfig {
-  readonly showFaceDetection?: boolean;
-  readonly showNameInput?: boolean;
-  readonly showPhotoTips?: boolean;
-  readonly maxFileSizeMB?: number;
-  readonly maxNameLength?: number;
-}
-
-export interface PartnerStepScreenProps {
-  readonly translations: PartnerStepScreenTranslations;
-  readonly t: (key: string) => string;
-  readonly initialName?: string;
-  readonly config?: PartnerStepScreenConfig;
-  readonly faceDetectionEnabled?: boolean;
-  readonly onFaceDetectionToggle?: (enabled: boolean) => void;
-  readonly onBack: () => void;
-  readonly onContinue: (image: UploadedImage, name: string) => void;
-}
-
-const DEFAULT_CONFIG: PartnerStepScreenConfig = {
-  showFaceDetection: false,
-  showNameInput: false,
-  showPhotoTips: true,
-  maxFileSizeMB: 10,
-  maxNameLength: 30,
-};
-
-export const PartnerStepScreen: React.FC<PartnerStepScreenProps> = ({
-  translations,
-  t,
-  initialName = "",
-  config = DEFAULT_CONFIG,
-  faceDetectionEnabled = false,
-  onFaceDetectionToggle,
-  onBack,
-  onContinue,
-}) => {
-  const tokens = useAppDesignTokens();
-
-  const { image, name, setName, handlePickImage, canContinue } = usePartnerStep({
-    initialName,
-    config: { maxFileSizeMB: config.maxFileSizeMB },
-    translations: {
-      fileTooLarge: translations.fileTooLarge,
-      maxFileSize: translations.maxFileSize,
-      error: translations.error,
-      uploadFailed: translations.uploadFailed,
-    },
-  });
-
-  const handleContinuePress = () => {
-    if (!canContinue || !image) return;
-    onContinue(image, name);
-  };
-
-  const styles = useMemo(() => createStyles(tokens), [tokens]);
-  const showFaceDetection = config.showFaceDetection ?? false;
-  const showNameInput = config.showNameInput ?? false;
-  const showPhotoTips = config.showPhotoTips ?? true;
-
-  return (
-    <View style={[styles.container, { backgroundColor: tokens.colors.backgroundPrimary }]}>
-      <NavigationHeader
-        title={translations.title}
-        onBackPress={onBack}
-        rightElement={
-          <TouchableOpacity
-            onPress={handleContinuePress}
-            activeOpacity={0.7}
-            disabled={!canContinue || !image}
-            style={[
-              styles.continueButton,
-              {
-                backgroundColor: canContinue && image ? tokens.colors.primary : tokens.colors.surfaceVariant,
-                opacity: canContinue && image ? 1 : 0.5,
-              },
-            ]}
-          >
-            <AtomicText
-              type="bodyMedium"
-              style={[
-                styles.continueText,
-                { color: canContinue && image ? tokens.colors.onPrimary : tokens.colors.textSecondary },
-              ]}
-            >
-              {translations.continue}
-            </AtomicText>
-            <AtomicIcon
-              name="arrow-forward"
-              size="sm"
-              color={canContinue && image ? "onPrimary" : "textSecondary"}
-            />
-          </TouchableOpacity>
-        }
-      />
-      <ScreenLayout
-        edges={["left", "right"]}
-        backgroundColor="transparent"
-        scrollable={true}
-        keyboardAvoiding={true}
-        contentContainerStyle={styles.scrollContent}
-        hideScrollIndicator={true}
-      >
-        <AtomicText style={[styles.subtitle, { color: tokens.colors.textSecondary }]}>
-          {translations.subtitle}
-        </AtomicText>
-
-        {showPhotoTips && <PhotoTips t={t} />}
-
-        {showFaceDetection && onFaceDetectionToggle && (
-          <FaceDetectionToggle
-            isEnabled={faceDetectionEnabled}
-            onToggle={onFaceDetectionToggle}
-            label={translations.faceDetectionLabel ?? ""}
-            hidden={true}
-          />
-        )}
-
-        <PhotoUploadCard
-          imageUri={image?.previewUrl || null}
-          onPress={handlePickImage}
-          isValidating={false}
-          isValid={null}
-          translations={{
-            tapToUpload: translations.tapToUpload,
-            selectPhoto: translations.selectPhoto,
-            change: translations.change,
-            analyzing: translations.analyzing,
-          }}
-        />
-
-        {showNameInput && (
-          <PartnerInfoInput
-            t={t}
-            name={name}
-            onNameChange={setName}
-            showName={true}
-            maxNameLength={config.maxNameLength}
-          />
-        )}
-        {translations.aiDisclosure && (
-          <View style={styles.disclosureContainer}>
-            <AtomicText
-              type="labelSmall"
-              style={[styles.disclosureText, { color: tokens.colors.textSecondary }]}
-            >
-              {translations.aiDisclosure}
-            </AtomicText>
-          </View>
-        )}
-      </ScreenLayout>
-    </View>
-  );
-};
-
-const createStyles = (tokens: DesignTokens) =>
-  StyleSheet.create({
-    container: {
-      flex: 1,
-    },
-    scrollContent: {
-      paddingBottom: 40,
-    },
-    subtitle: {
-      fontSize: 16,
-      textAlign: "center",
-      marginHorizontal: 24,
-      marginBottom: 24,
-    },
-    continueButton: {
-      flexDirection: "row",
-      alignItems: "center",
-      paddingHorizontal: tokens.spacing.md,
-      paddingVertical: tokens.spacing.xs,
-      borderRadius: tokens.borders.radius.full,
-    },
-    continueText: {
-      fontWeight: "800",
-      marginRight: 4,
-    },
-    disclosureContainer: {
-      marginTop: 24,
-      marginHorizontal: 24,
-      padding: 16,
-      borderRadius: 12,
-      backgroundColor: tokens.colors.surfaceVariant + "40",
-    },
-    disclosureText: {
-      textAlign: "center",
-      lineHeight: 18,
-      opacity: 0.8,
-    },
-  });

package/src/features/partner-upload/presentation/screens/index.ts

@@ -1,6 +0,0 @@
-export { PartnerStepScreen } from "./PartnerStepScreen";
-export type {
-  PartnerStepScreenProps,
-  PartnerStepScreenTranslations,
-  PartnerStepScreenConfig,
-} from "./PartnerStepScreen";

package/src/features/photo-restoration/README.md

@@ -1,399 +0,0 @@
-# Photo Restoration Feature
-
-Restore and enhance old, blurry, or damaged photos using AI.
-
-## 📍 Import Path
-
-```typescript
-import { usePhotoRestoreFeature } from '@umituz/react-native-ai-generation-content';
-```
-
-**Location**: `src/features/photo-restoration/`
-
-## 🎯 Feature Purpose
-
-Repair and enhance damaged, old, or low-quality photographs using AI. Removes scratches, fixes blur, colorizes black & white photos, and restores facial details.
-
----
-
-## 📋 Usage Strategy
-
-### When to Use This Feature
-
-✅ **Use Cases:**
-- Restoring old family photographs
-- Repairing scratched or torn photos
-- Fixing blurry or out-of-focus images
-- Colorizing black and white photos
-- Enhancing vintage photograph quality
-- Preserving historical images
-
-❌ **When NOT to Use:**
-- Simple brightness/contrast adjustments (use basic image editing)
-- Background removal (use Remove Background feature)
-- Face swapping (use Face Swap feature)
-- artistic style changes (use Style Transfer)
-
-### Implementation Strategy
-
-1. **Select restoration type** (auto or specific)
-2. **Upload photo** with clear issues visible
-3. **Preview before/after** comparison
-4. **Allow re-processing** with different settings
-5. **Save high-resolution result**
-6. **Provide quality feedback** mechanism
-
----
-
-## ⚠️ Critical Rules (MUST FOLLOW)
-
-### 1. Image Requirements
-- **MUST** provide ONE image to restore
-- **MUST** use high-quality scan (min 1024x1024 recommended)
-- **MUST** ensure photo has visible issues to fix
-- **MUST** use supported formats (JPEG, PNG)
-- **MUST NOT** exceed file size limits (20MB max)
-
-### 2. Configuration
-- **MUST** provide valid `userId` for tracking
-- **MUST** specify `restorationType` (auto or specific)
-- **MUST** implement `onError` callback
-- **MUST** implement `onSelectPhoto` callback
-- **MUST** handle all restoration states
-
-### 3. State Management
-- **MUST** check `isReady` before enabling restore button
-- **MUST** display progress during restoration
-- **MUST** handle long processing times (show progress)
-- **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 long operations
-- **MUST** cache restored images locally
-- **MUST** allow users to cancel processing
-- **MUST NOT** restore multiple images simultaneously
-
-### 5. User Experience
-- **MUST** provide before/after comparison
-- **MUST** allow re-processing with different settings
-- **MUST** show estimated processing time
-- **MUST** handle restoration failures gracefully
-- **MUST** provide download/share options
-
----
-
-## 🚫 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 restoration without user action
-   - Always require explicit "Restore" 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 restoration failures
-   - Always explain what went wrong
-   - Provide retry or alternative options
-
-5. **No Memory Leaks**
-   - Never store large original and restored images simultaneously
-   - 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 of long operations
-
-7. **No Loss of Original**
-   - Never overwrite original photo
-   - Always keep original for comparison
-   - Store both versions separately
-
----
-
-## 🤖 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 photo restoration feature using @umituz/react-native-ai-generation-content.
-
-REQUIREMENTS:
-1. Import from: @umituz/react-native-ai-generation-content
-2. Use the usePhotoRestoreFeature hook
-3. Select restoration type (auto or specific)
-4. Implement photo selection UI
-5. Validate photo before restoration
-6. Show before/after comparison
-7. Handle long processing times with progress
-8. Implement proper error handling
-9. Allow re-processing with different settings
-10. Implement cleanup on unmount
-
-CRITICAL RULES:
-- MUST validate photo before calling restore()
-- MUST show before/after comparison
-- MUST never overwrite original photo
-- MUST handle long processing times
-- MUST allow re-processing
-- MUST implement debouncing (300ms)
-
-CONFIGURATION:
-- Provide valid userId (string)
-- Set restorationType: 'auto' | 'scratches' | 'blur' | 'colorize' | 'all'
-- Implement onSelectPhoto callback
-- Implement onSaveResult callback
-- Configure callbacks: onProcessingStart, onProcessingComplete, onError
-
-RESTORATION OPTIONS:
-- removeScratches: boolean (remove scratches and tears)
-- fixBlur: boolean (fix blurry photos)
-- colorize: boolean (add color to B&W photos)
-- enhanceFaces: boolean (restore facial details)
-- adjustContrast: boolean (improve contrast and brightness)
-
-STRICTLY FORBIDDEN:
-- No missing photo validation
-- No auto-processing without user action
-- No hardcoded API keys
-- No unhandled errors
-- No memory leaks
-- No overwriting original photo
-- No blocking UI
-
-QUALITY CHECKLIST:
-- [ ] Photo selection implemented
-- [ ] Restoration type selector
-- [ ] Before/after comparison view
-- [ ] Progress indicator for long operations
-- [ ] Error display with retry option
-- [ ] Re-processing with different settings
-- [ ] Download/share functionality
-- [ ] Original photo preserved
-```
-
-#### AI Implementation Checklist
-
-Use this checklist when generating code:
-
-- [ ] Feature imported from correct path
-- [ ] Photo selection implemented
-- [ ] Restoration type selector added
-- [ ] Validation before restore()
-- [ ] Before/after comparison view
-- [ ] Progress indicator during processing
-- [ ] Error display with user-friendly message
-- [ ] Re-processing option available
-- [ ] Original photo preserved
-- [ ] Download/share buttons
-- [ ] Cleanup on unmount
-- [ ] Image compression configured
-
----
-
-## 🛠️ Configuration Strategy
-
-### Essential Configuration
-
-```typescript
-// Required fields
-{
-  userId: string
-  restorationType: 'auto' | 'scratches' | 'blur' | 'colorize' | 'all'
-  onSelectPhoto: () => Promise<string | null>
-}
-
-// Optional callbacks
-{
-  onProcessingStart?: () => void
-  onProcessingComplete?: (result) => void
-  onError?: (error: string) => void
-}
-```
-
-### Recommended Settings
-
-1. **Restoration Types**
-   - Auto: Let AI detect issues (recommended for most cases)
-   - Scratches: Remove scratches, tears, stains
-   - Blur: Fix blurry or out-of-focus images
-   - Colorize: Add color to black & white photos
-   - All: Apply all restoration techniques
-
-2. **Image Quality**
-   - Minimum scan: 1024x1024 resolution
-   - Recommended: 2048x2048 or higher
-   - Format: JPEG or PNG
-   - Max size: 20MB
-
-3. **Performance Settings**
-   - Compress images before upload
-   - Show progress for long operations
-   - Implement timeout (120s default)
-   - Enable result caching
-
----
-
-## 📊 State Management
-
-### Feature States
-
-**isReady**: boolean
-- Photo selected and validated
-- Check before enabling restore button
-
-**isProcessing**: boolean
-- Restoration in progress
-- Show loading/progress indicator
-- Disable restore button
-
-**progress**: number (0-100)
-- Restoration progress percentage
-- Update progress bar
-
-**error**: string | null
-- Error message if restoration failed
-- Display to user with clear message
-
-**result**: {
-  imageUrl: string
-  originalImageUrl?: string
-  restorationType?: string
-  metadata?: any
-}
-
----
-
-## 🎨 Best Practices
-
-### Photo Selection
-
-1. **Scan Quality**
-   - Good: High-resolution scan (300 DPI or higher)
-   - Bad: Low-quality photo of photo
-
-2. **Lighting**
-   - Good: Even, well-lit scans
-   - Bad: Harsh shadows or glare
-
-3. **Damage Assessment**
-   - Start with auto mode to detect issues
-   - Use specific restoration for targeted fixes
-
-4. **Multiple Restorations**
-   - Some photos benefit from multiple passes
-   - Allow re-processing with different settings
-
-### User Experience
-
-1. **Before/After Comparison**
-   - Show side-by-side comparison
-   - Add slider or toggle for easy comparison
-   - Zoom capability for detail inspection
-
-2. **Progress Feedback**
-   - Show estimated time remaining
-   - Update progress regularly
-   - Allow cancellation
-
-3. **Quality Options**
-   - Offer multiple restoration types
-   - Show examples of each type
-   - Recommend best option
-
----
-
-## 🐛 Common Pitfalls
-
-### Quality Issues
-
-❌ **Problem**: Poor restoration quality
-✅ **Solution**: Use higher resolution scans, try different restoration types
-
-### Performance Issues
-
-❌ **Problem**: Very slow processing
-✅ **Solution**: Compress images, show progress, allow cancellation
-
-### User Confusion
-
-❌ **Problem**: Users don't see improvement
-✅ **Solution**: Provide before/after comparison, zoom capability
-
-### Memory Issues
-
-❌ **Problem**: App crashes with large images
-✅ **Solution**: Compress images, implement streaming, clean up properly
-
----
-
-## 📦 Related Components
-
-Use these components from the library:
-
-- **PhotoUploadCard**: Upload photo interface
-- **ResultDisplay**: Before/after comparison
-- **RestorationTypeSelector**: Choose restoration type
-- **ProgressBar**: Progress display
-- **ImageComparison**: Side-by-side comparison
-
-Located at: `src/presentation/components/`
-
----
-
-## 🔄 Migration Strategy
-
-If migrating from previous implementation:
-
-1. **Update imports** to new path
-2. **Add restoration type selector**
-3. **Implement before/after comparison**
-4. **Update state handling** for new structure
-5. **Add re-processing capability**
-6. **Test all restoration types**
-
----
-
-## 📚 Additional Resources
-
-- Main documentation: `/docs/`
-- API reference: `/docs/api/`
-- Examples: `/docs/examples/basic/photo-restoration/`
-- 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 before/after comparison guidelines
-
-### v1.0.0 - Initial Release
-- Initial feature documentation

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

@@ -1 +0,0 @@
-export * from "./types";

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

@@ -1,9 +0,0 @@
-export type {
-  PhotoRestoreOptions,
-  PhotoRestoreRequest,
-  PhotoRestoreResult,
-  PhotoRestoreFeatureState,
-  PhotoRestoreTranslations,
-  PhotoRestoreFeatureConfig,
-  PhotoRestoreResultExtractor,
-} from "./photo-restore.types";

package/src/features/photo-restoration/domain/types/photo-restore.types.ts

@@ -1,64 +0,0 @@
-/**
- * Photo Restore Feature Types
- * Request, Result, Config types for photo restoration
- */
-
-export interface PhotoRestoreOptions {
-  fixScratches?: boolean;
-  enhanceFaces?: boolean;
-  colorize?: boolean;
-}
-
-export interface PhotoRestoreRequest {
-  imageUri: string;
-  imageBase64?: string;
-  userId: string;
-  options?: PhotoRestoreOptions;
-}
-
-export interface PhotoRestoreResult {
-  success: boolean;
-  imageUrl?: string;
-  imageBase64?: string;
-  error?: string;
-  requestId?: string;
-}
-
-export interface PhotoRestoreFeatureState {
-  imageUri: string | null;
-  processedUrl: string | null;
-  isProcessing: boolean;
-  progress: number;
-  error: string | null;
-}
-
-export interface PhotoRestoreTranslations {
-  uploadTitle: string;
-  uploadSubtitle: string;
-  uploadChange: string;
-  uploadAnalyzing: string;
-  description: string;
-  processingText: string;
-  processButtonText: string;
-  successText: string;
-  saveButtonText: string;
-  tryAnotherText: string;
-  beforeLabel?: string;
-  afterLabel?: string;
-  compareHint?: string;
-}
-
-export type PhotoRestoreResultExtractor = (
-  result: unknown,
-) => string | undefined;
-
-export interface PhotoRestoreFeatureConfig {
-  featureType: "photo-restore";
-  creditCost?: number;
-  extractResult?: PhotoRestoreResultExtractor;
-  prepareImage: (imageUri: string) => Promise<string>;
-  onImageSelect?: (uri: string) => void;
-  onProcessingStart?: (data: { creationId: string; imageUri: string }) => void;
-  onProcessingComplete?: (result: PhotoRestoreResult & { creationId?: string }) => void;
-  onError?: (error: string, creationId?: string) => void;
-}