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

package/src/features/anime-selfie/README.md

@@ -1,396 +0,0 @@
-# Anime Selfie Feature
-
-Convert photos to anime/manga style using AI.
-
-## 📍 Import Path
-
-```typescript
-import { useAnimeSelfieFeature } from '@umituz/react-native-ai-generation-content';
-```
-
-**Location**: `src/features/anime-selfie/`
-
-## 🎯 Feature Purpose
-
-Transform photos into anime/manga style artwork using AI. Supports various anime styles with customizable intensity levels while preserving facial features.
-
----
-
-## 📋 Usage Strategy
-
-### When to Use This Feature
-
-✅ **Use Cases:**
-- Creating anime avatars
-- Generating manga-style portraits
-- Artistic photo transformations
-- Social media profile pictures
-- Fan art and creative projects
-
-❌ **When NOT to Use:**
-- General artistic style transfer (use Style Transfer)
-- Face swapping (use Face Swap)
-- Image editing and filters (use image editing software)
-- Copyrighted character replication
-
-### Implementation Strategy
-
-1. **Select photo** to convert to anime
-2. **Choose anime style** (shonen, shojo, chibi, etc.)
-3. **Adjust intensity** level (0.0 to 1.0)
-4. **Generate anime version** with progress tracking
-5. **Preview and compare** with original
-6. **Save or share** result
-
----
-
-## ⚠️ Critical Rules (MUST FOLLOW)
-
-### 1. Image Requirements
-- **MUST** provide ONE image to convert
-- **MUST** use clear, well-lit photos
-- **MUST** have visible faces (for best results)
-- **MUST** use reasonable resolution (min 512x512)
-- **MUST NOT** exceed file size limits (10MB max)
-
-### 2. Configuration
-- **MUST** provide valid `userId` for tracking
-- **MUST** specify `style` (anime style type)
-- **MUST** set `intensity` level (0.0 to 1.0)
-- **MUST** implement `onError` callback
-- **MUST** implement `onSelectPhoto` callback
-
-### 3. State Management
-- **MUST** check `isReady` before enabling convert button
-- **MUST** display progress during conversion
-- **MUST** handle long processing times
-- **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** allow users to cancel processing
-- **MUST NOT** convert multiple images simultaneously
-
-### 5. Content Quality
-- **MUST** provide before/after comparison
-- **MUST** allow intensity adjustment
-- **MUST** handle various photo types
-- **MUST** preserve facial features when enabled
-- **MUST** offer style regeneration
-
----
-
-## 🚫 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 conversion without user action
-   - Always require explicit "Convert" button press
-   - Show 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 conversion failures
-   - Always explain what went wrong
-   - Provide retry or alternative options
-
-5. **No Memory Leaks**
-   - Never store both original and converted large images simultaneously
-   - Clean up temporary images
-   - Implement proper image disposal
-
-6. **No Blocked UI**
-   - Never block main thread with image processing
-   - Always show progress indicator
-   - Allow cancellation
-
-7. **No Copyright Violations**
-   - Never replicate copyrighted anime characters exactly
-   - Allow style transformation only
-   - Implement content moderation
-
----
-
-## 🤖 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 an anime selfie feature using @umituz/react-native-ai-generation-content.
-
-REQUIREMENTS:
-1. Import from: @umituz/react-native-ai-generation-content
-2. Use the useAnimeSelfieFeature hook
-3. Select anime style type
-4. Implement image selection UI
-5. Adjust intensity level (0.0 to 1.0)
-6. Validate image before conversion
-7. Show before/after comparison
-8. Handle long processing times with progress
-9. Implement proper error handling
-10. Implement cleanup on unmount
-
-CRITICAL RULES:
-- MUST validate image before calling convert()
-- MUST show before/after comparison
-- MUST handle intensity adjustment
-- MUST preserve facial features when enabled
-- MUST implement debouncing (300ms)
-- MUST allow style regeneration
-
-CONFIGURATION:
-- Provide valid userId (string)
-- Set style: 'shonen' | 'shojo' | 'chibi' | 'realistic'
-- Set intensity: 0.0 to 1.0 (default: 0.8)
-- Implement onSelectPhoto callback
-- Implement onSaveResult callback
-- Configure callbacks: onProcessingStart, onProcessingComplete, onError
-
-OPTIONS:
-- style: Select anime style type
-- intensity: 0.0 (subtle) to 1.0 (full transformation)
-- preserveFaces: boolean (maintain facial features)
-
-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 copyright violations
-
-QUALITY CHECKLIST:
-- [ ] Image selection implemented
-- [ ] Style selector added
-- [ ] Intensity slider included
-- [ ] Before/after comparison view
-- [ ] Progress indicator during processing
-- [ ] Error display with retry option
-- [ ] Download/share functionality
-- [ ] Style regeneration option
-```
-
-#### AI Implementation Checklist
-
-Use this checklist when generating code:
-
-- [ ] Feature imported from correct path
-- [ ] Image selection implemented
-- [ ] Style selector added
-- [ ] Intensity control implemented
-- [ ] Validation before convert()
-- [ ] Before/after comparison view
-- [ ] Progress indicator during processing
-- [ ] Error display with user-friendly message
-- [ ] Download/share buttons
-- [ ] Style regeneration option
-- [ ] Cleanup on unmount
-- [ ] Original image preserved
-
----
-
-## 🛠️ Configuration Strategy
-
-### Essential Configuration
-
-```typescript
-// Required fields
-{
-  userId: string
-  style: 'shonen' | 'shojo' | 'chibi' | 'realistic'
-  intensity: number  // 0.0 to 1.0
-  onSelectPhoto: () => Promise<string | null>
-}
-
-// Optional callbacks
-{
-  onProcessingStart?: () => void
-  onProcessingComplete?: (result) => void
-  onError?: (error: string) => void
-}
-```
-
-### Recommended Settings
-
-1. **Anime Styles**
-   - Shonen: Action-oriented, bold lines
-   - Shojo: Elegant, detailed features
-   - Chibi: Cute, exaggerated proportions
-   - Realistic: Anime-style but realistic proportions
-
-2. **Intensity Levels**
-   - 0.3-0.5: Subtle anime influence
-   - 0.6-0.8: Balanced transformation (recommended)
-   - 0.9-1.0: Full anime style
-
-3. **Image Quality**
-   - Minimum: 512x512 resolution
-   - Recommended: 1024x1024 or higher
-   - Format: JPEG or PNG
-   - Max size: 10MB
-
----
-
-## 📊 State Management
-
-### Feature States
-
-**isReady**: boolean
-- Photo selected and validated
-- Check before enabling convert button
-
-**isProcessing**: boolean
-- Anime conversion in progress
-- Show loading/progress indicator
-- Disable convert button
-
-**progress**: number (0-100)
-- Conversion progress percentage
-- Update progress bar
-
-**error**: string | null
-- Error message if conversion failed
-- Display to user with clear message
-
-**result**: {
-  imageUrl: string
-  originalImageUrl?: string
-  style?: string
-  intensity?: number
-  metadata?: any
-}
-
----
-
-## 🎨 Best Practices
-
-### Photo Selection
-
-1. **Image Quality**
-   - Good: Clear, well-lit photos
-   - Bad: Blurry, dark images
-
-2. **Subject Clarity**
-   - Good: Clear facial features visible
-   - Bad: Occluded or distant faces
-
-3. **Style Matching**
-   - Match style to photo content
-   - Consider gender and age for style
-
-4. **Intensity**
-   - Start with moderate intensity (0.7-0.8)
-   - Adjust based on results
-
-### User Experience
-
-1. **Before/After Comparison**
-   - Side-by-side comparison
-   - Slider or toggle for easy comparison
-   - Zoom capability for detail inspection
-
-2. **Style Preview**
-   - Show examples of each style
-   - Preview style before conversion
-   - Explain style characteristics
-
-3. **Progress Feedback**
-   - Show estimated time remaining
-   - Update progress regularly
-   - Allow cancellation
-
----
-
-## 🐛 Common Pitfalls
-
-### Quality Issues
-
-❌ **Problem**: Poor anime conversion
-✅ **Solution**: Use higher quality photos, try different style or intensity
-
-### Style Issues
-
-❌ **Problem**: Anime style doesn't match photo
-✅ **Solution**: Try different style, adjust intensity
-
-### Performance Issues
-
-❌ **Problem**: Slow conversion
-✅ **Solution**: Compress images, show progress, allow cancellation
-
-### Memory Issues
-
-❌ **Problem**: App crashes with large images
-✅ **Solution**: Compress images, clean up properly, optimize memory
-
----
-
-## 📦 Related Components
-
-Use these components from the library:
-
-- **PhotoUploadCard**: Upload photo interface
-- **ResultDisplay**: Before/after comparison
-- **StyleSelector**: Choose anime style
-- **IntensitySlider**: Adjust intensity
-- **ProgressBar**: Progress display
-
-Located at: `src/presentation/components/`
-
----
-
-## 🔄 Migration Strategy
-
-If migrating from previous implementation:
-
-1. **Update imports** to new path
-2. **Add style selector**
-3. **Implement intensity control**
-4. **Update state handling** for new structure
-5. **Add before/after comparison**
-6. **Test all anime styles**
-
----
-
-## 📚 Additional Resources
-
-- Main documentation: `/docs/`
-- API reference: `/docs/api/`
-- Examples: `/docs/examples/basic/anime-selfie/`
-- 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
-
-### v1.0.0 - Initial Release
-- Initial feature documentation

package/src/features/anime-selfie/domain/index.ts

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

package/src/features/anime-selfie/domain/types/anime-selfie.types.ts

@@ -1,52 +0,0 @@
-/**
- * Anime Selfie Feature Types
- */
-
-export type AnimeSelfieStyle = "anime" | "manga" | "cartoon" | "disney" | "pixar";
-
-export interface AnimeSelfieResult {
-  success: boolean;
-  imageUrl?: string;
-  imageBase64?: string;
-  error?: string;
-  requestId?: string;
-  creationId?: string;
-}
-
-export interface AnimeSelfieFeatureState {
-  imageUri: string | null;
-  processedUrl: string | null;
-  isProcessing: boolean;
-  progress: number;
-  error: string | null;
-}
-
-export interface AnimeSelfieTranslations {
-  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 AnimeSelfieResultExtractor = (result: unknown) => string | undefined;
-
-export interface AnimeSelfieFeatureConfig {
-  featureType: "anime-selfie";
-  creditCost?: number;
-  defaultStyle?: AnimeSelfieStyle;
-  extractResult?: AnimeSelfieResultExtractor;
-  prepareImage: (imageUri: string) => Promise<string>;
-  onImageSelect?: (uri: string) => void;
-  onProcessingStart?: (data: { creationId: string; imageUri: string }) => void;
-  onProcessingComplete?: (result: AnimeSelfieResult) => void;
-  onError?: (error: string, creationId?: string) => void;
-}

package/src/features/anime-selfie/domain/types/index.ts

@@ -1,8 +0,0 @@
-export type {
-  AnimeSelfieStyle,
-  AnimeSelfieResult,
-  AnimeSelfieFeatureState,
-  AnimeSelfieTranslations,
-  AnimeSelfieResultExtractor,
-  AnimeSelfieFeatureConfig,
-} from "./anime-selfie.types";

package/src/features/anime-selfie/index.ts

@@ -1,20 +0,0 @@
-/**
- * Anime Selfie Feature
- * Provider-agnostic anime selfie generation feature
- */
-
-// Domain Types
-export type {
-  AnimeSelfieStyle,
-  AnimeSelfieResult,
-  AnimeSelfieFeatureState,
-  AnimeSelfieTranslations,
-  AnimeSelfieFeatureConfig,
-  AnimeSelfieResultExtractor,
-} from "./domain";
-
-// Presentation Hooks
-export { useAnimeSelfieFeature, type UseAnimeSelfieFeatureProps } from "./presentation";
-
-// Presentation Components
-export { AnimeSelfieFeature, type AnimeSelfieFeatureProps } from "./presentation";

package/src/features/anime-selfie/presentation/components/AnimeSelfieFeature.tsx

@@ -1,86 +0,0 @@
-import React, { useMemo } from "react";
-import { Image, StyleSheet } from "react-native";
-import { PhotoUploadCard } from "../../../../presentation/components/PhotoUploadCard";
-import { SingleImageFeatureLayout } from "../../../../presentation/layouts";
-import type { SingleImageInputRenderProps, ResultRenderProps } from "../../../../presentation/layouts";
-import { useAnimeSelfieFeature } from "../hooks";
-import type { AnimeSelfieTranslations, AnimeSelfieFeatureConfig } from "../../domain/types";
-
-export interface AnimeSelfieFeatureProps {
-  config: AnimeSelfieFeatureConfig;
-  translations: AnimeSelfieTranslations & {
-    modalTitle?: string;
-    modalMessage?: string;
-    modalHint?: string;
-    modalBackgroundHint?: string;
-  };
-  onSelectImage: () => Promise<string | null>;
-  onSaveImage: (imageUrl: string) => Promise<void>;
-  onBeforeProcess?: () => Promise<boolean>;
-}
-
-export const AnimeSelfieFeature: React.FC<AnimeSelfieFeatureProps> = ({
-  config,
-  translations,
-  onSelectImage,
-  onSaveImage,
-  onBeforeProcess,
-}) => {
-  const feature = useAnimeSelfieFeature({
-    config,
-    onSelectImage,
-    onSaveImage,
-    onBeforeProcess,
-  });
-
-  const modalTranslations = useMemo(
-    () => ({
-      title: translations.modalTitle || "Processing",
-      message: translations.modalMessage || "AI is transforming 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,
-          }}
-        />
-      )}
-      renderResult={({ imageUrl, imageSize }: ResultRenderProps) => (
-        <Image
-          source={{ uri: imageUrl }}
-          style={[styles.resultImage, { width: imageSize, height: imageSize }]}
-          resizeMode="contain"
-        />
-      )}
-    />
-  );
-};
-
-const styles = StyleSheet.create({
-  resultImage: {
-    borderRadius: 16,
-  },
-});

package/src/features/anime-selfie/presentation/components/index.ts

@@ -1,2 +0,0 @@
-export { AnimeSelfieFeature } from "./AnimeSelfieFeature";
-export type { AnimeSelfieFeatureProps } from "./AnimeSelfieFeature";

package/src/features/anime-selfie/presentation/hooks/index.ts

@@ -1,9 +0,0 @@
-/**
- * Anime Selfie Presentation Hooks Index
- */
-
-export { useAnimeSelfieFeature } from "./useAnimeSelfieFeature";
-export type {
-  UseAnimeSelfieFeatureProps,
-  UseAnimeSelfieFeatureReturn,
-} from "./useAnimeSelfieFeature";

package/src/features/anime-selfie/presentation/hooks/useAnimeSelfieFeature.ts

@@ -1,59 +0,0 @@
-/**
- * useAnimeSelfieFeature Hook
- * Uses base single image hook for anime selfie transformation
- * Uses centralized orchestrator for credit/error handling
- */
-
-import { useMemo } from "react";
-import {
-  useSingleImageFeature,
-  type BaseSingleImageHookReturn,
-} from "../../../image-to-image";
-import type { AlertMessages } from "../../../../presentation/hooks/generation";
-import { createAnimeSelfiePrompt } from "../../../../domains/prompts";
-import type { AnimeSelfieFeatureConfig } from "../../domain/types";
-
-export interface UseAnimeSelfieFeatureProps {
-  config: AnimeSelfieFeatureConfig;
-  onSelectImage: () => Promise<string | null>;
-  onSaveImage: (imageUrl: string) => Promise<void>;
-  onBeforeProcess?: () => Promise<boolean>;
-}
-
-export interface UseAnimeSelfieFeatureOptions {
-  /** Alert messages for error handling */
-  alertMessages?: AlertMessages;
-  /** User ID for credit operations */
-  userId?: string;
-  /** Callback when credits are exhausted */
-  onCreditsExhausted?: () => void;
-}
-
-export type UseAnimeSelfieFeatureReturn = BaseSingleImageHookReturn;
-
-export function useAnimeSelfieFeature(
-  props: UseAnimeSelfieFeatureProps,
-  options?: UseAnimeSelfieFeatureOptions,
-): UseAnimeSelfieFeatureReturn {
-  const { config, onSelectImage, onSaveImage, onBeforeProcess } = props;
-
-  const promptConfig = useMemo(
-    () => createAnimeSelfiePrompt(config.defaultStyle),
-    [config.defaultStyle],
-  );
-
-  // Cast config to any to bypass strict type checking while maintaining runtime behavior
-  return useSingleImageFeature(
-    { config: config as never, onSelectImage, onSaveImage, onBeforeProcess },
-    {
-      buildInput: (imageBase64) => ({
-        imageBase64,
-        prompt: promptConfig.prompt,
-        options: {
-          guidance_scale: promptConfig.guidance_scale,
-        },
-      }),
-      ...options,
-    },
-  );
-}

package/src/features/anime-selfie/presentation/index.ts

@@ -1,6 +0,0 @@
-/**
- * Anime Selfie Presentation Index
- */
-
-export * from "./hooks";
-export * from "./components";